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When personal computers were 
still considered new inventions— 
way back in the late 1970’s—there 
was virtually no commercial soft- 
ware market. Even five years ago, 
almost all commercial software 
companies were relatively small 
concerns, unlike the multimillion- 
dollar firms that dominate the busi- 
ness today. Computer magazines 


then began to publish program list-. 


ings to fill the software void. 

Magazines remain an impor- 
tant source of software to this day. 
For a few dollars, they offer solid, 
useful programs and serve as an 
outlet for talented programmers. In 
nearly every user's software library 
are a favorite utilities, applications, 
educational programs, and games 
that originated in a magazine. 

COMPUTE! magazine has pub- 
lished many of these outstanding 
programs over the past eight years. 
Recently we decided to collect the 
best of them into special magazine/ 
disk editions such as the one you're 
reading now. Almost all of the back 
issues of COMPUTE! are out of print, 
and thousands of new users will 
find this collection invaluable. 

Collected in this special issue 
are the best home and recreational 
programs published by COMPUTE! 
for the 8-bit Atari line of computers 
over the past several years. There’s 
something here for every age, every 
level. Games, applications, and 
utilities. 

For game players, we've in- 
cluded action games and thinking 
games. Among them you'll find an 
exceptional version of the tradition- 
al game of ‘’Chess,” as well as “’La- 
ser Chess™,” a futuristic, prize- 
winning, original game. This issue 
also includes SpeedScript, a full- 
featured word processor, ready to 
load and run. In addition, we pre- 
sent a variety hints and tips for 
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Editor's Notes 


Atari users in two forms: Three of 
noted Atari developer Bill Wilkin- 
son’s favorite INSIGHT: Atari col- 
umns are reprinted as are several 
questions and answers culled from 
past Readers’ Feedback columns. 


Using The Programs 

Packed with this magazine is a disk 
containing most of the programs 
and examples described in these 
pages. Program files are stored on 
both sides of the disk; if you don’t 
find the files you need, turn the disk 
over and try again. These programs 
are ready to run and use. Before you 
begin, however, we recommend 
that you make a copy of this disk 
and then store the original safely 
away. 
The disk is not copy-protected. 
It is, however, write-protected — 
you can’t store additional data or 
modify the programs on this disk. 
Since some of the programs in this 
collection are designed to write to 
the disk, you must copy these pro- 
grams to another disk for them to 
work properly. 

Before using a program, check 
the introductory paragraph of the 
article which describes the program 
to see what disk files are used. Then 
follow the instructions in the article 
for running the program. All pro- 
grams on the disk work with Atari 
DOS versions 2.0 and 2.5. If you 
have only DOS 3.0, contact Atari to 
recieve 2.5—the most recent DOS. 
Many of the programs also work 
with DOS XL and OS/A+ from 
OSS—see the individual articles for 
more information. 

We're certain you'll enjoy 
these programs as much as the reg- 
ular readers of COMPUTE! have 
over the years, and we invite you to 
pick up COMPUTE! for valuable 
information and software for your 
Atari in the coming years. 
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Entire contents copyright ©1987 by COMPUTE! Publica- 
tions, Inc. All rights reserved. 


“Tf you know BASIC and want to learn 
machine language, this is the place to start 
.... Building on your experience as a 
BASIC programmer, Mansfield very gently 
takes you through the fundamentals of 


machine language.”’ 


—wWhole Earth Software Catalog 


COMPUTE! Books’ 


Best-selling Machine Language Books 


“Understandable’—The New York Times 


“Presents the machine language novice with a very 
good tutorial in simple, understandable terms.” 
—Antic 


“T highly recommend Machine Language for Begin- 
ners as your first introduction to the world of 
machine language.” 


—Commodore Power/Play 


Machine Language 
for Beginners 

Richard Mansfield 

Most commercial software is 
written in machine language be- 
cause it’s far faster and more 
versatile than BASIC. Machine 
Language for Beginners is a 
step-by-step introduction. In- 
cludes a simple assembler, a 
disassembler, and utilities, to 
help beginners write programs 
more quickly and easily. 
$16.95 

ISBN 0-942386-11-6 





Machine Language for Beginners and The Second Book of Machine Language: 
everything you need to learn machine language programming 
on your Apple, Atari, and Commodore personal computers. 


The LADS Disk 

LADS, the assembler used in The Second Book of 
Machine Language, is available on disk for only $12.95. 
This is a great accompaniment to the book, saving you 
hours of typing time by providing the complete source 
and object programs for all versions of the assembler, 
and more. And LADS disks are specific to your Apple, 
Atari, or Commodore computers. 


The Second Book of 
Machine Language 
Richard Mansfield 

The follow-up to the best-selling 
Machine Language for Begin- 
ners, this book leads the pro- 
grammer deeper into the most 
powerful and efficient program- 
ming techniques available for 
personal computers. Fully tu- 
torial, with easy step-by-step 
explanations, the book shows 
how to construct significant, 
effective machine language 
programs. Included is a high- 
speed, professional-quality, la- 
bel-based assembler. Everything 
that’s needed for optimized 
programming on the Com- 
modore 64, Apple, Atari, VIC-20, 
and PET/CBM computers. 
$16.95 

ISBN 0-942386-53-1 




















To Order: Call Toll Free 800-346-6767 (in NY 212-887-8525) or mail this coupon with your 





























I payment to COMPUTE! Books, P.O. Box 5038, F.D.R. Station, New York, NY 10150. I 
I The Second Book of Mecuine eireise $16.95 O Payment Enclosed (check or money order) | 
Machine Language for Beginners, $16.95 hi rCard i 
I LADS Disk, (Apple), $12.95, (531 APD) BIST lS Salil! (EME | 
LADS Disk, (Atari), $12.95, (531ATD) Acct. No. 
I LADS Disk (Commodore), $12.95, (531CMD) Exp. Date I 
J subtotal $ Name I 
NC residents add 5% sales tax $ Address 
I NY residents add 8.25% sales tax $ ; I 
City 
Shipping and handling $ e: 
I ($2.00 per book State Zip I 
| $1.00 per disk) I 
Total Paid —— : ‘i Fi 
A choceninbtpepessd COMPUTE! Pubiications,Inc. I 
Please allow 4-6 weeks for delivery. A Capital Cities/ABC. inc. Company 
L bl eee Eee eo d 





Try to outwit your computer with this 
fast, multilevel chess game. An Atari 
with at least 32K and a joystick is 
required. Disk File: CHESS.BAS. 


The world was amazed, in the late 
eighteenth century, by a machine 
that had the astonishing ability to 
play a good game of chess. It enter- 
tained kings and queens. It defeat- 
ed Napoleon, a master tactician. 
Hundreds of people paid to com- 
pete against it, but eventually it was 
revealed that a small man was hid- 
den inside the machine. 

A chess-playing machine re- 
mained only a dream until the late 
1950s when the first computer 
chess game was played. Now, the 
World Computer Championship, 
held every three years since 1974, 
attracts almost as much publicity as 
the human championship matches. 
Why has there been so much inter- 
est in machines that play games? 

One reason is that chess can be 
used to measure a computer's intel- 
ligence. Chess is easy to play, but 
difficult to master. So difficult, in 
fact, that some experts believe that 
a computer would have to be al- 
most as intelligent as a human to 
become world champion. 

Of course, another reason is 
that chess is just plain fun, but not if 
you can’t find an opponent. To be 
an entertaining opponent, a com- 
puter chess game should be fast, 
easy to use, and capable of playing 
at several different skill levels. 
“Chess” has all these features and 
more. Although it’s really no match 
against the best commercial chess 
games, it has managed to defeat 
these giants of the microcomputer 
chess world on rare occasions. 


Joystick Input 
After running the program, you will 
be asked to specify several play op- 











Chess 


John Krause 


tions. You can choose among five 
skill levels; start a new game or set 
up any position; play against the 
computer or watch it play against 
itself; or play either the white or 
black pieces. All of these options 
will be discussed in greater detail 
later, but for now, type 1 at each 
prompt. This puts you in command 
of the white pieces versus the com- 
puter on level one, the easiest level. 


The first time the program is 
run, you need to wait a few seconds 
while the computer gets its brain in 
order. Then the board will be dis- 
played with your pieces on the bot- 
tom of the screen and the computer's 
pieces on the top. You should see a 
frame around the square in the low- 
er-left corner of the board. This is 
the cursor which takes the place of 
your hand to move pieces around 
the board. 


Use the joystick, plugged into 
port 1, to move the cursor atop the 
piece you wish to move. Press and 
release the joystick button. Now 
move the cursor to the square you 
want to move to and tap the button 
again. Your piece moves to the new 
square, and the computer responds 
almost instantly with its move. 


A Spectacular Blunder 

Did you make a foolish move? No 
problem. One of the most valuable 
features of Chess is the ability to 
change the position by adding or 
deleting pieces. This feature is espe- 
cially useful for those of us who 
frequently manage to maneuver 
into a superior position, only to 
throw it all away in a single, spec- 
tacular blunder. 


A piece can be deleted by posi- 
tioning the cursor on the piece and 
pressing the space bar. To add a 
piece or change a piece to a differ- 
ent one, move the cursor to the 
appropriate square and press P, N, 
B, R, Q, or K for pawn, knight, 
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bishop, rook, queen, or king, re- 
spectively. This will put one of your 
pieces on the square. To add one of 
the computer's pieces, hold down 
the CONTROL key while pressing 
one of these editing keys. 

To take back a move, use the 
editing keys to delete your piece 
and put it back on its original 
square. Don’t forget to take back 
the computer’s move, too. 

The editing feature also en- 
ables you to make special moves 
which cannot be made with the 
joystick alone such as castling and 
en passant captures. For example, 
castling can be accomplished by de- 
leting the king and putting it on its 
new square, and then moving the 
rook as you normally would with 
the joystick. Although you can 
make these special moves, the com- 
puter will never castle or capture en 
passant because, due to their com- 
plexity, these moves were not in- 
cluded in its thinking routine. 


Strange Chess 

Although the computer will always 
make a legal move, it doesn’t check 
to see that you do the same. You are 
free to move any of your pieces to 
any square without so much as a 
contemptuous buzz from the com- 
puter. If you’re an experienced 
player, this shouldn't be a problem. 
If you're a beginner, however, you 
may want to familiarize yourself 
with the basic rules of chess lest 
you end up playing strange chess, a 
personal version which bears little 
resemblance to the real game. On 
the other hand, if you like to fudge 
a bit, the computer will make it 
easy. It will politely acquiesce to 
your most surreal moves. 

When a pawn reaches the oth- 
er side of the board, it’s automati- 
cally promoted to a queen. If you 
would rather have a knight, bishop, 
or rook, you can easily make the 
change using the editing keys. 

















Checkmate 

The computer thinks by analyzing 
thousands of possible moves and 
countermoves and choosing what it 
considers to be the best move based 
on the relative value of the pieces 
(see ‘“How Chess Thinks’’). Most 
positions don’t have just one best 
move but several which are equally 
good, in which case the computer 
chooses among them at random. 
This random factor insures that 
every game will be different, and 
makes for varied and interesting 
play. 

Play continues until one side is 
either checkmated or stalemated. 
The computer will then stop play 
and indicate which side has won. 

There are a few quirks in the 
way the computer determines 
whether checkmate has occurred. 
On levels three through five, it an- 
nounces checkmate prematurely. 
When this happens, the computer 
has determined that it’s impossible 
to avoid checkmate on the next 
move or two, assuming both sides 
make the best moves. 


Also, the computer doesn’t 
know the subtle difference between 
checkmate and stalemate. Conse- 
quently, when stalemate occurs, it 
will announce checkmate although, 
in fact, the game is a draw. Since 
the computer tries as hard as it can 
to checkmate its opponent, it will 
also try to achieve stalemate, possi- 
bly. forcing a draw when it could 
have won. Fortunately, this rarely 
happens because the conditions for 
stalemate exist only in unusual cir- 
cumstances such as when one side 
has only the king remaining. 


Also, the computer won't give 
you any hint when your king is in 
check (not checkmate). So be extra 
careful that you don’t leave your 
king in check or move into check. 
Otherwise, your king would be in 
check during the computer's turn to 
move—a highly unorthodox if not 
illegal position, The computer's re- 
ply to such a position is unpredict- 
able, but it usually announces 
checkmate, forcing you to restart 
the game. 

In any case, when the computer 
announces checkmate, press the 
joystick button to start a new game. 
If you want to try out some of the 
other play options without waiting 





How Chess Thinks 


You've probably heard that if a monkey sat down at a typewriter and 
pecked randomly at the keys for a long enough period of time, it would 
eventually type the complete works of Shakespeare. Theoretically, this is 
indeed possible—given enough time. There’s the rub. At a brisk typing 
speed of 50 words per minute, it would take that poor monkey billions of 
years just to type “To be, or not to be.” Nevertheless, there is power in trial 
and error. 


The Minimax Algorithm 

Substitute the monkey for a high-speed computer, and this technique 
becomes a practical method of imitating intelligence. In fact, it has been 
used with great success in the field of artificial intelligence. This program 
uses a popular trial-and-error technique known as the minimax algorithm. 

The computer looks at the present board position and mentally moves 
the pieces through all the possible combinations of future moves and 
countermoves up to a certain point, say three moves ahead. For each 
combination, it calculates a score based on which pieces were captured 
during the combination. Each piece is worth a certain number of points 
depending on its general importance: 1 point for a pawn, 3 for a knight or 
bishop, 5 for a rook, 9 for a queen, and 46 for a king. (Of course, since you 
lose the game if your king cannot escape capture, the value of a king is ac- 
tually infinite, but 46 is high enough to convince the computer that it’s a 
bad move.) 

When, in a move being examined, the computer captures an oppo- 
nent’s piece, the value of that piece is added to the score. Conversely, 
when one of the computer's pieces is captured, its value is subtracted from 
the score. Thus, a high score is considered good for the computer, and a 
low score is good for its opponent. 

The task is to find the combination that represents best play for both 
sides. This combination is not necessarily the one with the maximum 
score, because while the computer is trying to maximize the score, its 
opponent is trying just as hard to minimize it. The best combination gives 
maximum scores during the computer’s moves, and minimum scores 
during the opponent's moves. 

After the best combination has been found, the computer’s best move 
in the present position is simply the first move in the combination. The 
problem has been reduced from analyzing a chess position to finding the 
maximum and minimum of a series of numbers, which is much better 
suited to a computer. 


50 Million Combinations On Level 5 
Like most algorithms based on trial and error, this one requires sifting 
through an enormous number of combinations to find the best one. 
Fortunately, a few tricks can be used to reduce the combinations to a 
manageable number. This algorithm uses a technique called alpha-beta 
cutoff. It makes the computer search more intelligently, giving it the 
seemingly paradoxical ability to find the best move without looking at all 
the possible combinations. On level 5, for example, instead of having to 
search through roughly 2 billion combinations, it looks at only 50 million. 
Even so, it would take BASIC from now till 1986 to generate that 
many combinations. That’s why the algorithm is programmed in machine 
language. An advanced programming technique known as recursion (mak- 
ing a subroutine call itself) is used to generate all the possible combina- 
tions of moves. Capable of analyzing about 5000 combinations per 
second, this routine provides a moderate challenge at a reasonable playing 
speed. 
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till checkmate, you can start a new 
game at any time by pressing RESET 
and running the program again. 


Play Options 

When you choose the black pieces, 
the board will revolve so that you 
still play from the bottom. Since the 
player with the white pieces always 
moves first, you must wait for the 
computer to move before you will 
be allowed to make your first move. 

If you become mentally ex- 
hausted after several bouts against 
the computer, give your brain a rest 
and watch the computer play itself. 
When you select this option, just set 
the joystick aside and sit back and 
watch the action. Beginners will 
find this feature an excellent way to 
learn some good strategies to use 
against the computer. 

You don’t have to begin a 
game from the starting position. If 
you choose the option to set up a 
position, an empty board will be 
displayed and you can use the edit- 
ing keys to place pieces on the 
board in any position. When the 
position is set up, the computer will 
start thinking after you make your 
first move. 

This feature is especially useful 
for continuing a previous game or 
creating a problem for the computer 
to solve. It also allows you to experi- 
ment with hypothetical or down- 
right ridiculous positions. Live out 
your fantasy by giving yourself ten 
queens versus the computer's lone 
king. The position doesn’t even 
have to be a legal one. You could 
invent your own type of chess by 
giving each side two kings, for ex- 
ample, although the computer may 
get confused trying to determine 
when checkmate has occurred. 

One of the advantages of a 
computer opponent over a human 
is that you can tell the computer 
exactly how hard you want it to try 
to beat you, and it will obediently 
play at that level of difficulty. This 
is important because it’s no fun if 
you always lose or always win 
effortlessly. 

You have five skill levels to 
choose from. The difference be- 
tween one level and another is the 
number of moves ahead that the 
computer looks. On level 1, for ex- 
ample, it looks two moves ahead 








ceeding level looks ahead one more 
move than the previous level. 

Alas, the smarter play on the 
higher levels doesn’t come without 
a price. The further ahead the com- 
puter looks, the more moves it must 
examine and, hence, the longer it 
thinks. The thinking time varies 
greatly depending on the level 
(about one second per move on lev- 
el 1; about two hours on level 5). 

Here’s a rundown of the five 
levels: 


Level 1: Beginner. Thinking time: 
one second. Look ahead: two 
moves. Fast but dumb. 


Level 2: Intermediate. Thinking 
time: five seconds. Look ahead: 
three moves. Provides a reasonable 
challenge for impatient players. 


Level 3: Tournament. Thinking 
time: two minutes. Look ahead: 
four moves. Since the usual time 
limit for tournament play is 40 
moves in two hours, an average of 
three minutes per move, this level 
is best suited for serious players. 


Level 4: Mate in two. Thinking 
time: 30 minutes. Look ahead: five 
moves. Capable of solving most 
mate-in-two problems. 


Level 5: Postal chess. Thinking 
time: two hours. Look ahead: six 
moves. Simulates postal chess 
games where there is no time limit. 
Can avoid checkmate in two 
moves. 


The thinking times given here 
are average times. The actual time 
ranges from half to twice the aver- 
age time depending on the position. 

Level 4 can be used to solve 
mate-in-two problems such as 
those published in many newspa- 
pers. Just select the following op- 
tions: level 4, set up position, 
computer versus itself. Enter the 
position using the editing keys, and 
then make a do-nothing move by 
positioning the cursor over a white 
piece and pressing the joystick but- 
ton twice. After several minutes of 
deep thought, the computer should 
respond by moving one of the 
white pieces (the solution) and an- 
nouncing checkmate. The only 
mate-in-two problems that the 
computer cannot solve are those 
which involve castling, en passant 
captures, or pawn promotion. © 











' FREE 


30 DAY 


PREVIEW 
IN YOUR OWN HOME 





SHARE THE TOTAL 
EXPERIENCE OF 
PICTURE TAKING 
WITH TODAY’S TOP 
PROFESSIONALS 


Close-up views of the pros at work on 
location, in the studio and in the lab. 
New equipment and methods too difficult 
to capture in words and still pictures 
alone. MODERN PHOTOGRAPHY 
comes alive in each quarterly video issue 
—the perfect complement to your regular 
reading. Each video shows 60 minutes 
with MODERN PHOTOGRAPHY’ staff 
and some of the greatest figures in the 
photographic world. Feature stories and 
regular columns all designed to make 
you a better photographer. Plus, free 
bonus video segments from leading 
photographic equipment and service 
companies. 


———— 


FREE 30 DAY PREVIEW OFFER 


MODERN PHOTOGRAPHY 
VIDEO MAGAZINE 
Box 11368, Des Moines lA 50340-1368 


Rush orders call 1-800-999-8783 


Send my FREE 30 DAY PREVIEW, 

and sign me up for a full year of MODERN 
PHOTOGRAPHY VIDEO MAGAZINE for 
$79.95. I'll receive 4 quarterly video cassettes 
at a 20% savings off the single copy price. If 1 
am not completely satisfied with the premiere 
video, I can return the tape within 30 days 
and owe nothing. 





(J Bill me $79.95 for 4 quarterly issues. 
(Bill my Dj VISA (j MASTERCARD 


Account #: Expire date 














City: State: Zip: 








(its move and your reply). Each suc- 
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Chain Reaction 


Mark Tuitle 


Verison by Tim Midkiff, Editorial Programmer 


In this explosive strategy game for a 
variety of computers, the contest is 
never finished until your last bomb 
has been thrown. A joystick, plugged 
into port 1, is required. Disk File: 
CHAIN.BAS. 


“Chain Reaction” is a clever strate- 
gy game for one or two players. 
Whether you play against the com- 
puter or another human, the objec- 
tive is the same: to eliminate all of 
your opponent’s bomb-shaped 
pieces from the field of play. The 
game is played on a5 X 6 grid of 
squares, and the players alternate 
turns, placing one bomb in a square 
on each turn. To place a bomb, 
| move the cursor to the desired 
square and press the joystick button. 
The results of a move depend 
on how many bombs are already in 
the chosen square and adjacent 
squares. Whenever any square 
reaches ‘‘critical mass,” it explodes 
and sends its bombs into neighbor- 
ing squares. If those squares are al- 
ready loaded to capacity, they 
explode too, creating a chain reac- 
tion that can engulf a large area of 
the board. 


Bomb Begets Bomb 

When you run Chain Reaction, it 
begins by asking whether you wish 
to play with one or two players. If 





you’ve never played before, you 
may want to play a game or two 
against the computer to learn what 
sort of strategies it favors. When 
you choose to play against the com- 
puter, the program also asks 
whether you'd like the computer to 
take the first turn. 

The first part of most games 
involves placement of initial pieces, 
without many explosions. As the 
board fills up, however, explosions 
occur with increasing frequency. 
Play continues until one player's 
pieces are completely eliminated 
from the board. 

The position of a square in the 
grid determines how many bombs 
it requires to create an explosion. A 
corner square can hold a maximum 
of one bomb. When you place a 
second bomb in a corner square 
that already holds one, both bombs 
explode, sending a bomb of your 
color into two neighboring squares. 
After an explosion, the original 
square is emptied. 


Other squares require more 
bombs to create an explosion. A 
border square that isn’t on a corner 
can hold a maximum of two bombs. 
When you place a third bomb in a 
border square, its explosion sends 
three bombs into the squares that 
adjoin it. Squares in the center of 
the game board hold the most 
bombs and also create the most 





devastating explosions. When you 
place a fourth bomb in a central 
square, it sends four bombs into 
squares which adjoin that position. 

When an explosion sends 
bombs into adjacent squares, any 
bombs in that square change color 
to match the color of the exploding 
bombs. Should one of the adjoining 
squares surpass its limit, that 
square, too, will explode, creating 
the potential for even more explo- 
sions. This process continues until 
no more explosions are possible. 

Thus, the situation in Chain 
Reaction is often volatile. The lead 
frequently seesaws back and forth 
between players, as each creates in- 
creasingly more widespread chain 
reactions. Even if defeat seems al- 
most certain, you can often regain 
the lead with clever play. When a 
game ends, the program announces 
the winner and permits you to play 
a new game or quit. 

Like other games of strategy 
and placement, Chain Reaction re- 
wards the player who can think 
ahead. At first, you may be tempted 
to start making explosions as quick- 
ly as possible. But that’s not always 
the best long-term tactic. By spread- 
ing bombs of your color throughout 
the board, you may be able to sur- 
vive chain reactions that would 
otherwise wipe you out. 
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Here’s a finely detailed implementa- 
tion of the popular card game of Eu- 
chre. A joystick plugged into port 1 is 
required, Disk File: EUCHRE.BAS. 


“Euchre” is a four-handed transla- 
tion of the popular card game of the 
same name. In this version, you play 
with a computer partner against two 
computer opponents. The computer 
will deal the cards, keep score, and 
play your partner’s as well as your 
opponents’ hands. Even better, it 
never gets bored or commits blun- 
ders such as trumping your ace. 
Nearly all the subtleties of the origi- 
nal card game are reproduced faith- 
fully, including lone hands, short 
suits, and more. You can even 
choose different personalities for 
your partner and opponents. 


Computer Personalities 
The game begins by asking you to 
choose personalities for your part- 
ner and your opponents. Move the 
reverse-video cursor to your 
choices, and make selections by 
pressing the joystick button or the 
Return key. 

The normal personality plays a 
more cautious game, while the ag- 
gressive personality tends to take 
more risks. Both opponents must 
have the same personality, but the 





Euchre 


David Shimoda 


partner's personality is chosen sep- 
arately. This makes the game much 
more varied than if the computer 
players always stick to the same, 
predictable strategy. One of the 
more difficult combinations is to 
choose a normal partner and ag- 
gressive opponents. Of course, your 
own style of play will have an im- 
pact on which combination you 
prefer. 


Dealing And Trump 

This Euchre variation uses only 24 
cards from the standard 52-card 
deck. Each suit includes only the 9, 
10, jack, queen, king, and ace, (The 
ace is high.) Before actual play be- 
gins, the first dealer must be select- 
ed. This is done by dealing out 
cards until a jack of spades or jack 
of clubs is thrown. The first person 
who receives a black jack becomes 
the first dealer. After each hand, the 
position of dealer passes to the next 
player in clockwise order. 

The dealer deals out 5 cards to 
each player and then places 1 card, 
face up, on the center of the table. 
The program automatically deals 
the cards, as it handles many other 
details in this game. As a conse- 
quence of this scheme, only 21 of 
the 24 cards are in play for any 
given hand. (Three cards are al- 
ways left unplayed.) 

The next step is to choose 








trump; the trump suit is the most 
powerful of the four suits for the 
current hand. Trump is determined 
by moving around the table in 
clockwise order, giving each player 
an opportunity to choose whether 
the dealer should pick up the center 
card. Each player can either pass or 
order up—order the dealer to pick 
up the center card. When the dealer 
is forced to take the center card, that 
card’s suit becomes trump, and the 
dealer discards one card. The com- 
puter players, of course, decide for 
themselves whether to pass or or- 
der up in this phase of the game. 
If no player chooses to order 
up in the first circuit of the table, 
each player then has a chance to 
pick any other suit as trump. If no 
player chooses trump on the second 
circuit, the hand is thrown out com- 
pletely, and another is dealt. 


Lone Hands 

On certain occasions, a player may 
choose to exclude his partner from 
play, a tactic which is known as 
playing lonehand. The player who 
chooses trump must choose at the 
same time whether or not to play 
lonehand. If a player orders up a 
card into his partner’s hand, the 
player who ordered up must play 
lonehand. (If your partner is the 
dealer and you order up, you must 
play lonehand). 
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For instance, you might want 
to play lonehand in a case where 
you hold most of the high cards in a 
suit, and your partner is the dealer, 
and the center card is a high card of 
your strong suit. By excluding your 
partner and playing lonehand, you 
are in a very strong position to take 
most or all of the tricks. 


Tricks And Hands 

A hand consists of five tricks. A 
trick consists of all players laying 
down one card. The player to the 
left of the dealer throws down the 
first card in the first trick. Subse- 
quent tricks are begun by the win- 
ner of the previous trick. Suit must 
be followed within a trick. That is, 
you must throw a card of the suit 
which was led, as long as you have 
any card of that suit. 

If no trump cards are thrown in 
a trick, the trick is won by the play- 
er who laid the highest card of the 
leading suit. If trump is thrown, 
then the highest trump card takes 
the trick. 

For all suits except the trump 
suit, the rank of the cards follows 
the usual order. (The 9 is low, and 
the ace is high.) For the trump suit, 
however, the jack is the highest- 
ranking card. The jack of the same 
color, but different suit, is consid- 
ered part of the trump suit—and it is 
the second highest ranking card. For 
example, if the trump suit is chosen 
as clubs, it follows this ranking: 
jack of clubs 
jack of spades 
ace of clubs 
king of clubs 
queen of clubs 
10 of clubs 
9 of clubs 


A hand is won by the side 
which wins a majority of tricks 
(three or more). If you or your part- 
ner orders up a card, your side must 
take the majority of tricks in that 
hand or else be euchred, meaning 
that the opposite side gets two extra 
points. 


Scoring 

A game of Euchre ends when one 
side accumulates ten or more points. 
You score one point for winning a 
hand, two points for winning all the 
tricks in a hand, and four points for 
winning all the tricks lonehand. © 





Beehive 


Steve Michel 
Version by Kevin Mykytyn 


To avoid getting stung in this delight- 
ful strategy game, you'll need to plan 
ahead. Requires a joystick and runs 
on any Atari 400, 800, XL, or XE 
computer with at least 32K of memo- 
ry. Plug the joystick into port 1. Disk 
File: BEEHIVE.BAS. 


“Beehive” is a two-player strategy 
game that requires you to concen- 
trate fully and develop long-range 
planning skills. The game board 
consists of 121 hexagons arranged 
in a sloping 11 X 11 matrix, The 
name derives from the playing 
field’s resemblance to the geometric 
precision of a honeycomb. The first 
player is assigned the left and right 
borders of the honeycomb, while 
the second player is assigned the 
top and bottom edges. 

The object of the game is de- 
ceptively simple. Each player tries to 
connect a continuous line from one 
of his or her borders to the other. If 
you are player 1, for instance, you 
need to connect the left border with 
the right. The players alternate 
turns, filling in cells of the honey- 
comb one at a time. While attempt- 
ing to complete your own course, 
you must also try to block your op- 
ponent’s way, and this requires stra- 
tegic thinking. The first player to 
connect both borders wins the 
game. As a reward, tiny bee faces 
appear along the line of connection, 
clearly marking the path to victory. 

To choose a cell, move the 
pointer to the cell you wish to occu- 
py and press the fire button. The 
cell will be filled with a solid circle 
and your turn ends. While connect- 
ing your own borders, you should 
also be trying to prevent the other 
player from making a connection. 
Play continues until one player or 
the other completes a continuous 





line from one border to the other. 
At this point a victor is declared, 
and bee faces replace the circles 
along the entire winning route. 


Winning Strategies 

Like most two-player games, Bee- 
hive adjusts itself to the skill of the 
players. The basic concept is simple 
enough that even small children 
can enjoy playing. But when two 
knowledgeable players are matched, 
play proceeds at a much higher lev- 
el. The flexibility of the game al- 
lows many different strategies. 

Here are some important 
points for beginners to keep in 
mind. To begin with, your first 
move does not have to occur in one 
of your border rows. In fact, you 
can often establish a better strategic 
position by starting somewhere 
near the middle of the playing field. 
In a typical game you will have to 
swing back and forth between an 
expanding, offensive posture and a 
defensive, blocking posture. The 
middle areas accommodate both 
strategies well, 

Second, it is not necessary that 
all of your cells be connected. That 
is, a new cell doesn’t necessarily 
have to touch one of your existing 
cells. Any empty cell in the hive is 
fair game for either player, and it’s 
often advantageous to space out 
your cells to allow multiple paths 
between borders. Starting multiple 
pathways makes it harder for an 
opponent to block your progress 
completely. 

Finally, keep in mind that the 
hexagonal shape of each cell per- 
mits you to move in six different 
directions. Try not to get locked 
into a strict, straight-line strategy 
too often. Any pathway that con- 
nects both borders is legal, and in 
many cases the winning path will 
be quite roundabout. ec 
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Try to evade menacing alien ships in 
this fast, colorful action game. A joy- 
stick is required. Disk File: DODGER 
BAS. 


Get ready for a game which de- 
mands extremely sharp eye-hand 
coordination and judgment of time 
and distance. “Space Dodger” is an 
addictive test of your physical 
reflexes. 

When you type RUN, there’s a 
brief wait while the program initial- 
izes. Then the game opens with 
your spaceship on the left side of 
the screen, superimposed over a 
random starfield. On the right side 
of the screen is a lineup of several 
colorful alien ships. When the ac- 
tion starts, the aliens begin moving 
toward your ship at different 
speeds. Your job is to avoid a disas- 
trous midspace collision that will 
turn your vessel into a lump of 
smoking metal. 

To dodge the reckless aliens, 
you'll have to move up or down. But 
don’t move too far and try to escape 
the screen—the boundaries are 
guarded by cuboids (cube-shaped 
asteriods) zipping along at the speed 
of light. The cuboids are even more 
dangerous than the alien ships be- 
cause they travel too fast to dodge. 


Moving Up The Ranks 

The longer you evade the oncom- 
ing aliens, the more points you 
gain. However, you won't see your 
final score until you crash and the 
game ends. At that time you’re also 
ranked according to your value to 
the Space Service: Space Cadet, 











Matthew Marullo 
Version by Kevin Mykytyn 


Corporal, Sergeant, Captain, or 
Major. 

Every time you advance a 
rank, the game pauses briefly 
before it continues to the next level. 
When it restarts, you'll notice the 
alien ships fly across the screen 
even faster. Your score adds up 
faster, too. 

But beware—Space Dodger is 
not as easy as it looks. Chances are 
you'll play for quite a while before 
you even advance beyond Space 
Cadet. 

Space Dodger works on the 
400/800, XL series, and new XE 
series computers. With a joystick 
plugged into port 1, you can push 
the stick forward to move your ship 
up, and pull back to move the ship 
down. 

The Atari version’s multicol- 
ored alien ships are created with an 
unusual implementation of player/ 
missile (P/M) graphics. Ordinarily, 
the Atari can display a maximum of 
only four player shapes (or five if 
you combine the four missiles into 
an additional player), Each player 
can be only one color and is limited 
in width, but can be as tall as the 
entire screen. But in Space Dodger, 
one player is used for your ship, 
and the remaining three players are 
cleverly combined to make 12 mul- 
ticolor alien ships. 


The program takes advantage 
of a technique which allows multi- 
ple colors in overlapping players. 
All three alien players begin at the 
same horizontal location and are 
assigned different colors. The P/M 
shape data is then defined so that 
visible portions of the underlying 
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space Dodger 


alien players can be seen through 
“holes” in the overlapping players. 
Thus, each ship is actually a three- 
colored conglomerate of overlap- 
ping shapes. To create the effect of 
separate ships, the remaining P/M 
data is filled with zeros to make 
blank zones between each alien 
craft. 

The result is 12 multicolor 
ships, but without additional pro- 
gramming tricks, they'd all have to 
move in unison. Moving one alien 
player without the others would 
destroy the carefully arranged mul- 
ticolor effect. 

To move the aliens at different 
speeds and horizontal locations, 
Space Dodger uses display list inter- 
rupts. Briefly, the Atari display list 
is a set of instructions that tells the 
computer what to display at a given 
point on the screen as the TV's 
raster beam sweeps from top to bot- 
tom. By manipulating the display 
list with machine language rou- 
tines, Space Dodger makes its three 
overlapped players act like a dozen 
independently mobile shapes. 

The fast, smooth motion of the 
alien ships is achieved by moving 
them only during the Atari's vertical 
blank interrupt (the short interval 
during which the TV’s raster beam 
moves from the bottom of the screen 
to the top to scan another frame). 
Naturally, machine language is also 
needed to make this work. 

You can learn more about 
using both types of interrupts in De 
Re Atari, published by Atari Com- 
puters, Inc., as well as COMPUTE!’s 
First Book of Atari and COMPUTE!’s 
First Book of Atari Graphics. Cc 











Nearly everyone has played Pong or 
Breakout, two computer-game clas- 
sics. “Prisonball” creates an intense, 
two-player action game by drawing 
features from both of those games. 
Requires a set of game paddles, and 
an Atari 400, 800, XL, and XE com- 
puter with at least 48K memory. Atari 
Prisonball also requires a set of game 
paddles, Disk File; PRISON.BAS. 


“Prisonball” is a two-player action 
game that combines the best ele- 
ments from two classic computer 
games, Pong and Breakout. The ob- 
ject of the game is simple—knock 
out as many bricks as you can in the 
allotted time. Type in Prisonball 
from the listing for your computer; 
then save a copy of the program 
before you try to run it. Every ver- 
sion of the game is similar, so be 
sure to read the general game rules 
before referring to the specific notes 
for your computer. 


Break To The Center 

The game begins by displaying five 
colored walls running vertically 
down the center of the screen. Each 
player controls two paddles located 
at the left and right sides of the 
screen. Three balls appear at a ran- 
dom location and start bouncing 











John Scarborough 


on your side of the screen, move 
one of your paddles into its path to 
deflect the ball toward the walls. 
You can only hit a ball when it’s 
moving toward your paddles (away 
from the interior walls). Balls trav- 
elling from the opposite direction 
go right through your paddles. If 
you happen to miss a ball, it wraps 
around the screen and appears on 
the other side, giving your oppo- 
nent a chance to score. 

At the beginning of the game, 
all three balls are a neutral color. 
Each time you hit a ball, it changes 
to the color of your paddle. You 
score whenever a ball of your color 
hits one of the five interior walls. 
The score depends on which wall 
you hit. The center wall is the hard- 
est to reach, so it yields the most 
points. The two intermediate walls 
are worth less than the center wall. 
The outermost walls are easiest to 
hit and score the fewest points. 


The top of the screen displays 
each player's score and a count- 
down timer. When the timer runs to 
zero, the game ends and the player 
with the most points wins. 

Every time a ball hits one of the 
walls, a brick is knocked out of the 
wall at the point of impact. By aim- 
ing your shots carefully, you can 
bore a path through a wall and 





Prisonball 


between two walls. When this hap- 
pens, the ball bounces wildly back 
and forth between the walls, scor- 
ing many points in a short time. 


An additional bit of strategy has 
to do with the redrawing of walls. 
Whenever a wall has been de- 
stroyed, it is immediately redrawn. 
Some of the highest scores result 
when you trap one or more balls 
behind a wall when it is redrawn. 
Since the wall is new, the trapped 
balls may hit it many times before 
they break back out to the exterior. 

Prisonball runs on any eight- 
bit Atari computer (not on an ST) 
with at least 48K memory. Game 
paddles are required. Although the 
game is written in machine lan- 
guage, it is listed in the form of a 
BASIC loader which you run as you 
would any BASIC program. 

To play Prisonball, plug a pair 
of paddles into port 1, run the pro- 
gram, and press START. When 
both players are ready, press either 
paddle button to start the game. 
You score ten points for each brick 
from the center wall, five points for 
bricks from the two adjacent walls, 
and one point for bricks from the 
two outside walls. Each game lasts 
five minutes. The winner is the 
player with the highest score at the 
end of the elapsed time. c 


around the screen. When a ball is | move a ball into the interior space 
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Explore hidden caves, discover lost 
treasures, and battle fierce monsters. 
“The Hermit,” a complex text adven- 
ture, begins by placing you outside the 
underground domain of a most unusu- 
al recluse. Disk File: HERMIT.BAS, 
HERMIT.BEG, and HERMIT.DAT. 


In a secluded section of southern 
California (somewhere near Ba- 
kersfield), there once lived a name- 
less man. Referred to only as the 
hermit by his neighbors, rumors 
spread quickly about the life and 
possible occupation of this mysteri- 
ous recluse. Many accused him of 
stealing, while others claimed he 
hoarded the riches of extensive 
gold and diamond mines that were 
hidden beneath his property. All 
stories, however, agreed on one 
fact: The hermit was rich. 

The hermit is now deceased, 
and stories about him have dwin- 
dled. His shack, however, still 
stands. Was the hermit truly rich? 
Could his riches be somewhere on 
his property? Is it worth inves- 
tigating? 

The program presented here 
places you in front of the hermit’s 
old shack—and all you've got is a 
grappling hook, flare gun, and 
flare. Your goal is to find ten trea- 
sures, to deposit them in a safe 
place (a spaceship), and to make off 
with your loot (blast off in the 
spaceship). As with any adventure 
program, however, your task is hin- 
dered by strange creatures, difficult 
puzzles, and wrong turns. 


Interaction 

Program interaction is accom- 
plished with simple one- or two- 
word commands (see “Command 
Summary”). In two-word com- 
mands, the first word represents 
— 











Eric Bryant 


the action to be taken (the verb), 
while the second word represents 
the object that is to be affected (the 
noun). Only the first six characters 
of both the verb and the noun are 
evaluated. Because of this, you 
have to enter only the first six char- 
acters of any word. 

Most commands are self- 
explanatory. The PUT command, 
however, is a special case. Because 
of the two-word limit, the com- 
mand PUT BALL IN BOX is illegal. 
To get around this, the PUT com- 
mand requires two separate inputs. 
For example, the command PUT 
BALL IN BOX should be first en- 
tered as PUT BALL. Then the com- 
puter will ask where you wish to 
put it; you reply with BOX, and the 
program performs as instructed. 

The commands QUIT and RE- 
START also require some addition- 
al explanation. The QUIT 
command allows you to exit the 
program and displays your score 
and final ranking as an adventurer. 
Before actually exiting the program, 
the computer asks you if this is 
what you really wish to do. The 
command RESTART starts the ad- 
venture all over from the begin- 
ning, erasing all your deeds and 
failures. Again, the computer asks if 
this really is your intention. 

HERMIT.BAS is the main game 
program for The Hermit. To start 
the game, type RUN’ HERMIT 
.BAS”. The Hermit uses two data 
files named HERMIT.BEG and 
HERMIT.DAT. Make sure that a 
disk containing these files is in the 
drive when you run HERMIT.BEG. 

By default, the program as- 
sumes that the data files are on the 
disk found in D1:. By altering the 
string variable DRIVES in line 20, 
you can change this. For example, if 
you own an Atari 130XE, you can 





The Hermit 


set DRIVE$ equal to “’D8:” in order 
to take advantage of the computer's 
ramdisk. (If you use the ramdisk, 
you must first use the DUPLICATE 
FILES option of DOS to copy the 
files HERMIT.BEG and HERMIT 
.DAT to the ramdisk. Remember 
that the contents of a ramdisk are 
lost whenever the computer is 
turned off.) If the data files are not 
on the disk in drive 1, you must 
change line 20 of HERMIT.BAS so 
that the main program knows 
where to look for its data. 


Hints, Tips, And Clues 

If you are the type of adventurer 
who does not need or want help, 
then read no further. If on the other 
hand, you find yourself stuck in a 
seemingly impossible situation; the 
following paragraphs should be of 
some assistance. 

First, a good rule of thumb in 
any adventure program is to exam- 
ine everything—clues may be hid- 
den anywhere. And don’t forget to 
make a map. Making a map of your 
adventure realm speeds up your 
journey and decreases your 
chances of missing any treasures. 
Also, pick up any object you find. 
You never know when an object 
may become useful, Finally, use 
your imagination. Successfully tra- 
versing an adventure takes a lot of 
creative problem solving. 

Now for specific hints: If you 
are stuck in the hut, push the refrig- 
erator. To take the pouch without 
falling through the floor, hook the 
pouch with your grappling hook. 
Drop the metal rod on the broken 
piece of track before entering the 
coal bin. To exit the room contain- 
ing the pedestal, place the sapphire 
on top of the pedestal (don’t forget 
to remove the sapphire before you 
leave). 
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Command Summary 


One-Word Commands 











Command Abbreviation 

NORTH N 

SOUTH Ss 

EAST EB 

WEST W 

UP U 

DOWN D 

DIVE none 

LOOK L 

INVENTORY I 

SCORE none 

RESTART none 

QUIT 

Two-Word Commands 

Command Example 

ATTACK ATTACK MUMMY 

BUILD BUILD RAFT 

CLOSE CLOSE BOX 

CUT CUT VINE 

DRINK DRINK ELIXIR 

DROP DROP LANTERN 

ENTER ENTER RAFT 

EXAMINE EXAMINE PEDESTAL 

EXIT EXIT RAFT 

FILL FILL LANTERN 

HIT HIT TREE 

HOOK HOOK CLIFF 

LIFT LIFT MATTRESS 

LIGHT LIGHT LANTERN 

OFFER OFFER TRIDENT 

OPEN OPEN BOX 

PUSH PUSH REFRIGERATOR 

PUT PUT FLARE (then enter) 
GUN 

READ READ SIGN 

RUB RUB LAMP 

SAY SAY HELLO 

SHOOT SHOOT FLARE 

TAKE TAKE LANTERN 





You may climb the cliff by 
hooking it with the grappling hook. 
Build a raft out of logs and vine. Cut 
the vine from the giant oak. If you 
lift the mattress in the sunken ship, 
you will find a treasure. You may 
have to dive twice to avoid running 
out of air. 

To avoid the bear, fire your 
flare at him. Light the mummy. Use 
the crossbow to shoot the stick at 
the leopard. If you rub the lamp 
while in the pentacle room, a de- 
mon will appear. Offer the demon 
the trident (you didn’t really want it 
anyway). Answer the sphinx’s 
question by saying water. Enter the 
door guarded by the dragon statue 
by putting sand in its mouth. Hit 
the rock using your pick to get the 
launch card. And last but not least, 
drop all treasures in the spaceship 
before attempting to blast off. © 

















The Climber 5 screen consists 





Climber 


James Rogers 


As ballboy for a baseball team, it's 
your job to retrieve a home-run ball 
from the top of a nearby building. 
Time is of the essence, but you still 
need to avoid moving obstacles on 
your way to the top. A joystick is 
required. Disk File: CLIMBER5.OB] 


“Play ball,” the umpire cries, and 
the game begins. As ballboy for the 
home team, your job is easy: Re- 
trieve stray balls and return them to 
the umpire. The number 5 on the 
back of your uniform shows that 
you're part of the team, and your 
job is more important than some 
might think, since it so happens 
that this game is being played with 
only one baseball. If a ball flies into 
the stands or out of the park, the 
game grinds to a halt while a stadi- 
um full of fans and players waits for 
you to bring it back. 

You're used to the pressure, 
but that doesn’t make the waiting 
any easier. The first inning passes, 
followed by the second and third, 
without any problem. Then, at the 
top of the fourth inning, the first 
batter swats a towering homer over 
the left-field wall. Up, up it goes, so 
high that you grab your field glass- 
es to track it. Yes, it’s outside the 
stadium—looks like a long sprint to 
get it back. Oh, no! Did that really 
happen? The ball lodges at the top 
of a neighboring building which is 
still under construction. As you 
rush to retrieve the prize, you'll 
have to duck and dodge to avoid 
obstacles on the construction-site. 





of several horizontal levels. When 
the game begins, you are at the 
bottom right corner of the screen, 
and the ball is at the upper left. 
Your job is to climb and run to 
where the ball lies, avoiding all the 
moving obstacles along the way. 
Since some of the moving objects 
are speedy indeed, that’s more dif- 
ficult than you might imagine at 
first. You can move left or right 
with the joystick or keyboard con- 
trols, depending on what version 
you're playing. 

Each level is connected to the 
next by one or more ladders, The 
joystick or keyboard controls allow 
you to move up or down a ladder; 
of course, you must be aligned with 
the ladder in order to ascend or 
descend on it. 

You have a total of five players 
when the game begins. Whenever 
you hit a moving object, you lose 
one player. The game ends when 
you have lost all your players. If 
you reach the ball without being 
hit, the program displays a congrat- 
ulatory message and lets you try the 
next skill level, where everything 
becomes more difficult. 

To get started, load the game 
by entering the DOS menu and 
using the L option to load the bina- 
ty file (CLIMBER5.OBJ). You then 
use DOS option M to begin execut- 
ing the program. Specify 4000 as 
the execution address. If you use 
DOS XL, OS/A+, or a similar al- 
ternative DOS, you can start the 
game simply by typing CLIMBERS 
-OBJ at a DOS prompt. 

Press START to begin the game 
or to restart it when a game is over.G 
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Here’s an action game that challenges 
both your driving skills and powers of 
concentration. A joystick is required. 
Disk File: MIAMI.BAS. 


Ah, Miami—sun city of the South. 
A sparkling metropolis blessed 
with a tropical climate, palm trees, 
beaches, revived art deco architec- 
ture, stylish pastels, and classy ele- 
gance. Almost paradise. 

You wake up on another bright, 
sunny Miami morning, sip a glass 
of freshly squeezed orange juice, 
don your white linen suit and sun- 
glasses, and stroll outside—then 
get the shock of your life. 

What's going on here? Over- 
night, a freak shift in the jet streams 
has piped a blistering cold front 
down from Ohio. The weatherman 
had predicted a brief shower last 
evening, but that’s not what hap- 
pened, Instead, the Florida penin- 
sula was blasted by the worst ice 
storm in 400 years. The Everglades 
are frozen solid. The pink flamin- 
gos are blue. And the streets of 
Miami are coated with a shimmer- 
ing layer of slippery ice. 

As you start your car—the 
pampered engine coughs and sput- 
ters in the bitter cold—you wonder 
what it’s going to be like driving to 
work. A Miami native, you’ve nev- 
er driven on ice before. In fact, 
you've never even seen this much 
ice since your boss’s retirement par- 
ty last year, when the caterers made 
that life-size ice sculpture of Ponce 
de Leon. You've heard the horror 
stories told by tourists about winter 
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Jeff Kulezycki 
Version by Kevin Mykytyn 


driving conditions up North, but 
never thought it could happen to 
you—not here, in Miami. 

The minute you pull out onto 
the street, your worst fears come 
true. When you step on the gas 
pedal, the wheels spin and the car 
accelerates sluggishly. When you 
turn the steering wheel, the car 
slides all over the road. And when 
you step on the brakes—well, for- 
get it. 

You realize, desperately, that 
you've got to make it to the parking 
garage across town without smash- 
ing your car to smithereens. It 
won't be easy. But at least there’s 
one thing in your favor—you’ve 
got the whole road to yourself. 
Everyone else, it seems, had the 
good sense to stay home. 


Out Of Control 

Using a joystick, you have to drive 
your car over ice-covered streets to 
reach the safety of a garage. The 
joystick button is the gas pedal, and 
pushing the stick right or left steers 
the car in the corresponding 
direction. 


But here’s the twist—the car 
doesn’t respond instantly to your 
commands. It tends to slide in the 
same direction even after you've 
steered it toward another direction. 
Then, when you try to recover, you 
often overcorrect and start sliding 
in yet another new direction. It’s an 
inertial nightmare—much like real 
winter driving. 

When you hit a guardrail or 
some other obstruction, your car 
cracks up. You get three cars per 





Miami Ice 


game. If you reach the safety of the 
garage, the game isn’t over. Instead, 
you advance to another screen 
whose streets are even harder to 
navigate. 

The number of points you 
score depends on how soon you 
reach the garage. As an incentive to 
recklessness, a timer starts counting 
down when you begin each new 
screen. If you reach the garage, you 
score the number of points left on 
the timer. If the timer runs out, you 
can still reach the garage, but you 
won't get any points. However, you 
will advance to the next screen, 

Atari Miami Ice is written large- 
ly in BASIC, but has an interrupt- 
driven machine language 
subroutine to move the car using 
player/missile graphics. The car it- 
self is composed of all four players 
to gain more resolution and colors. 

Plug a joystick into port 1. To 
steer your car safely into the park- 
ing garage and advance to the next 
screen, you have to enter the front 
of the garage without bumping into 
the black lines which mark its three 
walls. Indicators on the screen 
show the timer value and your cur- 
rent score. 

There are seven screens in all. 
You'll notice that some screens have 
more than one route to the garage. 
The first time you play the game, it 
starts at screen 1. Subsequent games 
begin at the screen where the last 
game ended, But you can start a new 
game at any screen you want by 
moving the joystick up or down to 
change the screen number. cS 

















Switchbox 


Todd Heimarck, Assistant Editor 


Here’s a challenging game of strategy 
that looks easy at first, but takes time 
to master and permits many varia- 
tions, Disk File: SWITCH.BAS. 


Playing ‘Switchbox” is like putting 
dominos in place for a chain reac- 
tion—either you're setting them in 
position or you're knocking them 
over. Winning requires skill and a 
sense of when to go for points and 
when to lay back and wait for a 
better board. The goal is simple: You 
try to score more points than your 
opponent by dropping balls into a 
box full of two-way switches, Each 
switch has a trigger and a platform. 
If the ball lands on an empty plat- 
form, it stops dead. But if it hits a 
trigger, it reverses the switch and 
continues, In many cases dropping a 
single ball creates a cascading ef- 
fect—one ball sets another in mo- 
tion, which sets others in motion, 
etc., all the way down. 


A Box Of Switches 
Switchbox is a tale of twos: Each 
switch has two parts, two positions, 
two states, two paths in, and two 
paths out. The two parts are the 
platform and the trigger. A switch 
can lean to the left (platform left, 
trigger right) or to the right (plat- 
form right, trigger left). 

The trigger is weak, and al- 


Version by Kevin Mykytyn 








Figure 1. Trigger States 
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Figure 2. Loaded Trigger 
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ways allows balls to pass. But the 
platform is strong enough to hold a 
single ball. So the platform either 
holds a ball—it’s full—or it does 
not and is empty. When a ball sits 
on a platform, the switch is said to 
be loaded, or full. 

Figure 2 shows a full switch 
over two empty switches. The plat- 
form holds a ball and leans to the 
left. The trigger extends to the right. 
Note that the switch on top has two 
pathways leading in, the left path 
and the right, and that the right 
path leading out is the left path into 
one of the switches below. The left 
path of the top switch leads into the 
right path of the other, the switch 
below and to the Jeft. If you drop a 
ball down the righthand path, it 
hits the trigger and flips that switch 
to the right. Then it continues 
down, hits the lefthand trigger be- 
low and flips that switch as well. 

In the meantime, the ball on 
the platform is set in motion (when 
the switch is flipped) and then hits 
the trigger. The top switch is reset 
to point to-the left. The second ball 
then drops a level to the platform 
below, where it stops. The playing 
field is composed of five levels, 
with four switches in the first level 
and eight in the bottom level. At the 
beginning of the game, there are no 
balls on the field—all platforms are 
empty—and the position of each 
switch is chosen randomly. 
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Players alternate dropping balls 
into one of eight entry points. 
These balls (and others) may or 
may not make it all the way 
through the switchbox, to one of 
the 16 exit paths. Balls fall straight 
down (with one exception), so a 
ball’s movement is always predict- 
able. When it hits an empty switch, 
one of two things can happen. If it 
lands on the empty platform, it 
stops dead in its tracks. But if it 
lands ona trigger, it falls through to 
the next level below. 

Moving balls always make it 
through loaded switches. Triggers 
allow balls to continue, and move 
the switch to the other position. If 
it’s loaded, the dead ball on the 
platform is put into motion and it 
hits the trigger that just moved over. 
This makes the switch go back to its 
original position, but with an empty 
platform. So when a ball hits the 
trigger of a loaded switch, its motion 
continues unabated. The switch 
moves, the ball on the platform be- 
gins to fall and it hits the newly 
placed trigger. The newly emptied 
switch moves back again, and the 
two balls drop to the next level. 

There’s one more possibility: a 
ball dropping onto a platform that 
already holds a ball. A platform 
can’t hold any more than one ball, 
so when this happens one of the 
balls slides over to the trigger. So 
the ball does not move straight 
down—it slides over to the next 
pathway. This is the exception to 
the rule that balls drop in a straight 
line. Of course, when the ball hits 
the trigger, the switch changes po- 
sition, causing the other ball to drop 
and hit the trigger. 


The Chain Reaction 
At the game’s start, all platforms 
are empty, so four of eight entry 
paths are blocked. Remember that 
your turn ends when a ball hits an 
empty platform and stops. As the 
switches fill up, the chances in- 
crease that a ball will descend 
through several levels. The goal is 
to score points by getting balls to 
pass all the way through the maze 
of the switchbox. The best way to 
collect a lot of points is to cause a 
chain reaction. 

A ball that hits a loaded switch 
from either side continues on its 








Moving Down The Path way. And the previously inert ball | turn it is. On the other side of the 


on the platform starts moving. One 
enters, two exit. If both of those 
balls encounter full platforms, four 
drop from the switches. The path- 
ways are staggered, so the effects 
can spread outward, with more and 
more balls cascading toward the 
bottom. 

Rather than taking an easy 
point or two, it’s often worthwhile 
to build up layers of loaded switch- 
es. Watch out for leaving yourself 
vulnerable, though. Because play- 
ers take turns, you'll want to leave 
positions where your opponent's 
move gives you a chance to create a 
chain reaction. The best strategy is 
to play defensively. Look ahead a 
move or two, and watch for an 
opening that allows you to score 
several points at once. 


Four Quarters 

A game of Switchbox always lasts 
four rounds. In the first (equality), 
each exit counts for two points. 
Your goal is to score ten points. The 
second quarter has more points 
available, as well as a higher goal. If 
you look at the exits, you'll see that 
the further away from the middle, 
the higher the point value. The 
numbers increase in a “Fibonacci” 
sequence: 1, 2, 3, 5, 8, and so on. 
Each number is the sum of the pre- 
vious two (1+2 is 3,2+3is5,3+5 
is 8, etc.). The target score in round 
two is 40. 

In round three the numbers are 
a bit lower. They increase arithmet- 
ically (1, 2, 3, 4, up to 8 in the 
corners). A goal of 20 points brings 
you to round four, where you can 
score big. Here the numbers are 
squares: 1, 4, 9, 16, 25, all the way 
to 64 at the edges. In rounds two 
through four, it’s sometimes pru- 
dent to leave a middle path open 
for your opponent to score a few 
points, in order to gather a high 
score on the big numbers to the left 
and right. 

Each round lasts until one 
player has reached the goal. At that 
point the other player has one last 
turn before the round ends. It’s pos- 
sible to win the round on this last- 
chance play; watch out for barely 
topping the goal and leaving a 
chain reaction open for the other 
player. An arrow points to the 
scoreboard of the player whose 
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screen, you'll see a number where 
the arrow should be. That's the goal 
for the current round (the Amiga 
version displays the goal on both 
sides of the screen, below the 
scoreboards). 

Bonus points are awarded at 
the conclusion of each round. Four 
numbers appear below the score- 
cards. The first is simply the total so 
far. The second is the total plus a 
bonus of the goal for the round if the 
player’s points are equal to or 
greater than the goal. For example if 
the goal is 20 and you get 18, there’s 
no bonus. If you score 22, the bonus 
is the goal for that round (20) and 
you'd have 42 points. The third 
number under the scoreboard is the 
difference between scores for the 
rounds. If you win by two points, 
two is added to your score (and two 
is subtracted from the other player). 
The final number is the grand total 
of the first three scores and bonuses. 
Rounds one and three are fairly low- 
scoring with low goals. You may 
want to seed the field with extra 
balls during these quarters, so you 
can collect more points in the sec- 
ond and fourth quarters. 


Variations 

Although the goal of the game is to 
score the most points, there’s no 
reason you couldn’t agree to play 
for low score. In a “lowball’”’ game, 
you would try to avoid scoring 
points. You wouldn’t necessarily 
play backwards, you would have to 
adjust the strategy of where to place 
the balls. Fill up the board as much 
as possible and leave your oppo- 
nent in a situation where he or she 
is forced to score points. 

The DATA statements at the 
beginning of the program (the Setup: 
routine in the Amiga version) deter- 
mine the goal for each round and 
the point values for the exit paths. 
You can prolong the game by dou- 
bling the goals; this also dilutes the 
value of a big score at the beginning 
of a round, preventing one player 
from winning on the first or second 
turn. An interesting variation is to 
assign negative values to some slots. 
If some paths score negative points, 
you are forced to think harder about 
where the balls will drop. ] 








In addition to the numbered 
keys (1-8), the plus (+) and minus 


This collection of flight guidebooks helps you get the 








most out of flight simulation software. Designed to be 
used with Flight Simulator, Flight Simulator Il, F-15 Strike 
Eagle, and other fighter-jet simulations, these books 
contain scores of scenarios that lead you across the 
U.S., around the world, into battle, and back to your 


favorite landing strips. 


Flying on Instruments with 

Flight Simulator 

Jonathan M. Stern 251 pages 
Here's fascinating hands-on instruction on fly- 
ing with instruments In Flight Simulator and 
Flight Simulator Il, How to fly in all kinds of 
weather—when the cloud ceiling is low or the 
visibility Is reduced, How to read and fly the in- 
strument approach charts that instrument- 
rated pilots use, How to take off, fly to 
another airport, and land—all while the clouds 
are a mere 200 feet off the ground. And how 
to navigate by using the impressive in- 
struments available in Flight Simulator and 
Flight Simulator II, More than 130 actual In- 
strument approach procedure charts, For all 
versions of Flight Simulator and Flight Simu- 
lator Il (Apple. Amiga, Atari, Atari ST, Com- 
modore, IBM PC and compatibles, Macintosh), 
Flight Simulator or Flight Simulator |/ required. 
Perfect-bound edition: 

$9.95 ISBN 0-87455-091-2 

Split-wire-bound edition: 

$12.95 ISBN 0-87455-103-X 


COMPUTE!’s Flight Simulator Adventures 
for the Macintosh, Amiga, and Atarl ST 
David Florance, Tom R. Halfhill, and Philip |. 
Nelson 227 pages 
Fly through mists Into mystery. This collection 
of 48 exciting, new, customized simulator 
scenarios for the Macintosh, Commodore 
Amiga, and Atari ST personal computers puts 
you in the pilot's seat. The new generation of 
Flight Simulator and Flight Simulator II offers 
better graphics, easier-to-use controls, and 


more airports. With this book, you'll experience 
hair-raising rescue missions, dangerous night 
landings, sightseeing side trips, and one-of-a- 
kind flights of fancy, Make COMPUTE!'s Flight 
Simulator Adventures your copilot and thrill to 
hours of flight. 

Flight Simulator or Flight Simulator II required. 
$12.95 ISBN 0-87455-100-5 


Learning to Fly with Flight Simulator 
John Rafferty 

Learn to fly like a simulator expert in the 
imaginary world of Flight Simulator and Flight 
Simulator II. You'll learn all the fun- 
damentals—from takeoffs to landings—in a 
single, detailed flight, Then you'll develop 
those flying skills by practicing standard rate 
turns, executing a flight plan, navigating from 
point A to point B, and more, Learn how to 
make precision landings and use the more 
advanced instruments in your aircraft. To cap 
your training—and turn you into a professional 
simulator pilot—you'll learn how to read and 
use the actual FAA approach charts commer- 
cial pllots fly with. This complete flight-instruc- 
tion tutorial was written by a professional pilot. 
$12.95 ISBN 0-87455-115-3 


40 Great Flight Simulator Adventures 
Charles Gulick 152 pages 
This bestselling volume offers 40 exciting, cus- 
tomized flight simulator scenarios for Flight 
Simulator and Flight Simulator Il on the Apple 
ll, IBM, Commodore 64, and Atari personal 
computers. 

$10.95 ISBN 0-87455-022-x 
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40 More Great Flight Simulator 
Adventures 
Charles Gulick 


236 pages 
Forty more challenging flight simulator scenar- 
los for Microsoft's Flight Simulator and 
SubLOGIC'’s Flight Simulator II. Explore the 
world from the air. For the Apple Il, IBM, Com- 
modore 64, and Atari personal computers, 
$12.95 ISBN 0-87455-043-2 


Jet Fighter School: Alr Combat 
Simulator Tactics and Maneuvers 
Richard G. Sheffield 177 pages 
Learn actual combat maneuvers and much 
more with this hands-on book for popular jet- 
combat simulators like F-15 Strike Eagle, Jet, 
and Ace. Information about jet fighter pilots 
and their aircraft, especially the F-15, provides 
an excellent introduction to the subject, 
There's even detailed data about the weap- 
ons available to jet-combat simulator pilots. 
The heart of the book demonstrates, step-by- 
step, numerous offensive and defensive com- 
bat flight maneuvers, from the Hi Yo-Yo to the 
Defensive Spiral Drive. Tactical tips on F-15 
Strike Eagle scenarios round out the book, F- 
15 Strike Eagle or other jet-combat flight simu- 
lator required. 

Perfect-bound edition: 

$9.95 ISBN 0-87455-092-0 

Split-wire-bound edition: 

$12.95 ISBN 0-87455-104-8 


Ask for COMPUTE! Books at your local book or computer store. 
To order direct, call toll free 800-346-6767 (in N.Y. call 212-887-8525) or write COMPUTE! Books, P.O. Box 


5038, F.D.R. Station, New York, NY 10019. 


Customer Service hours are 10:00 am-12:30 pm and 1:30 pm-3:00 pm EST. 


Please include $2.00 shipping and handling in the U.S. or $5.00 airmail. NC residents add 5 percent sales tax and NY 
residents add 8.25 percent sales tax. Please allow 4-6 weeks for delivery. 


COMPUTE! Publications,Inc. 


A Capital Cities/ABC, Inc. Company 


COMPUTE! books are available outside the United States from subsidiaries of 
McGraw-Hill international Book Company. 











(—) keys are active. Pressing plus 
drops a ball at random down one of 
the eight entry paths. Pressing mi- 
nus allows you to pass your turn to 
your opponent. 

Once you've mastered the reg- 
ular game, you can add some new 
tules. Each player gets three passes 
per half, similar to the three time- 
outs in a football game. If you don’t 
like the looks of the board, press the 
minus key to use one of your 
passes. After one player has 
skipped a turn, the other player 
must play (this prevents the possi- 
bility of six passes in a row). It’s also 
a good idea to make a rule that a 
player can’t pass on two consecu- 
tive turns. You can also give each 
player two random moves to be 
played for the opponent. In other 
words, after making a move, you 
could inform your opponent that 
you're going to give him one of 
your random moves and you would 
press the plus key. 

Here’s one more change you 
could make: Instead of alternating 
turns, allow a player to continue 





after scoring. When a player drops a 
ball and scores some points, the 
other player would have to pass (by 
pressing the minus key). If the first 
player scores again, the opponent 
passes again, and so on until no 
more points are scored. 


Playing Solitaire 

To drop a ball, press a numbered 
key (1-8). If you're using a 128, ST 
or Amiga, the numeric keypad is 
convenient for choosing a move. By 
using the pass and random turn 
options, you can play against the 
computer. Here are the rules for 
solitaire play: 


1, The computer always scores 
first. At the beginning of every 
round, the computer plays random- 
ly until at least one point is ac- 
quired. Press the plus key for the 
computer's turn. You must contin- 
ue passing (skip your turn with the 
minus key) until the computer puts 
points on the board. 


2. After the first score by the 
computer, you can begin to play. 





When the computer has a turn, press 
the plus key for a random move. 

3. Whenever you make points, 
you must pass again until the com- 
puter scores. When the computer 
gets more points, you can begin to 
play again. This rule means you 
should hold back on the easy scores 
of a few points; wait until there’s an 
avalanche available. 


4. If you're the first to reach the 
goal, the computer gets a last 
chance. Don’t make this move ran- 
domly; figure out the best opportu- 
nity for scoring and play that move 
for the last-chance turn. 


In the interest of keeping this 
program to a manageable length, 
no attempt has been made to pro- 
vide an “‘intelligent’’ computer op- 
ponent. Once you become familiar 
with the game, you might find it an 
interesting project to try adding 
some routines that give the com- 
puter a rational basis for picking 
one move over another. (o} 








Tired of blasting invaders from outer 
space? This whimsical game is set ina 
very different world—the miniature 
jungle in your own backyard. A joy- 
stick is required. Disk File: WEBSTER 
.BAS, 


Guide Webster, the hungry tree spi- 
der, in his endless search for a 
square meal. Roving back and forth 
across his tree limb, he watches for 
bugs to appear in the grass below. 
When the time is right, he drops 
down on a strand of silk for a light 
snack, then climbs back up his web 
to look for more. 

Unfortunately, this backyard 
paradise isn’t quite perfect. The 











Walter Bulawa 


more Webster eats, the faster the 
bugs move, making it harder to find 
the next meal. Even worse, he’s not 
the only one with an appetite— 
there's a speedy scorpion sharing 
the same hunting ground, stealing 
bugs when he can and giving Web- 
ster a sting whenever he drops too 
close. 

“Webster Dines Out” will run 
on any Atari computer with at least 
32K memory. Use the joystick to 
move Webster left or right at the 
top of the screen. When a bug 
passes below, press the button to 
make him drop down. 

Your goal is to score points as 
quickly as possible. Each bug is 
worth 25 points and you get 50 
bonus points for snaring two bugs 





Webster Dines Ouf 


in a single drop. Webster has three 
lives in each game; getting stung by 
the scorpion costs you a life but 
does not reduce your score. The 
scorpion is a tough competitor: 
When Webster drops down, the 
scorpion speeds up to increase his 
chances of stealing a bug. 

There are six skill levels, each 
harder than the last. As you ad- 
vance to higher levels, the bugs and 
scorpion speed up, the grass grows 
longer, and a grey rock appears in 
the lawn. The other creatures hide 
behind these objects, but Webster 
can drop behind them too. The 
game ends when you lose all three 
lives or exhaust your time at the 
highest skill level. 
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Laser Chess’ 


Version by Rhett Anderson, Assistant Editor 


Laser Chess is a two-player strategy 
game patterned after traditional 
chess—with some fascinating new 
twists. The original version, which 
won a $5,000 prize in a programming 
contest sponsored by COMPUTE!’s 
Atari ST Disk and Magazine, was 
written in Modula-2 language for the 
Atari ST. Here we provide a BASIC 
translation for the Atari XL and XE, 
At least one joystick is required. Disk 
File: LASER.BAS. 


Laser Chess™, as the name implies, 
is a chesslike strategy game for two 
players, The goal is to manipulate a 
laser-firing piece and various reflec- 
tive objects to eliminate your oppo- 
nent's king. As in traditional chess, 
there are an infinite number of 
ways to accomplish this. 

There are eight basic types of 
pieces in Laser Chess, and each has 
unique capabilities. Over time, 
you'll learn each piece’s advantages 
and limitations. Obviously, the 
more you play Laser Chess, the more 
you'll understand the pieces in your 
arsenal, which in turn will make you 
a better player. So let’s start with a 
description of the pieces. 


A Geometric Army 

The figure illustrates each piece and 
its name. When you run the pro- 
gram, you'll notice that some sides 
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of some pieces are highlighted. This 
indicates a reflective surface. When 
a laser beam strikes a reflective sur- 
face, it bounces off without harm- 
ing the piece. But if a piece is hit by 
a laser on a nonreflective surface, it 
is destroyed. 


These are the basic pieces 
in Laser Chess. 
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A piece can also be removed 
from the board if it is captured by 
an opposing piece. This is similar to 
traditional chess; to capture a piece, 
you simply move one of your own 
pieces onto its square. 

In addition to their ability to 
move from square to square, pieces 
with reflective surfaces can also be 
rotated in place in 90-degree incre- 
ments. This lets you orient the piece 
to protect it against opposing laser 
shots, or to set up bounce shots 
with your own laser. 





The king is the most important 
piece in Laser Chess. When the king 
is eliminated, the other player wins 
the game. Since it has no reflective 
surfaces, it can be destroyed by a 
laser from any angle. It can also be 
captured by an opposing piece. The 
king is not totally defenseless, how- 
ever. It can capture any opposing 
piece by moving onto its square. 
But you can use it for a capture only 
once per turn. 

The second most important 
piece is the laser. This piece is your 
primary offensive weapon; it’s the 
only piece which can fire a laser 
shot. To take aim, you can rotate it 
in place at 90-degree angles. Like 
the king, the laser is completely 
vulnerable to enemy laser strikes, 
because it has no reflective sur- 
faces. If you lose your laser, the 
game is not over, but only the most 
skillful (or incredibly lucky) player 
can overcome its loss. 


Tricky Pieces 

The hypercube is an interesting 
piece. It can’t harm an opposing 
piece directly, but may very well do 
so indirectly. When the hypercube 
is moved onto another piece (even 
your own), that piece disappears 
from its original position and reap- 
pears on a randomly selected emp- 
ty square. This can happen only 
once per turn. The hypercube can 
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be a two-edged sword; it may relo- 
cate a piece to a vulnerable posi- 
tion, or it may make it possible for 
the piece to capture an important 
opposing piece on the next move. 
The hypercube has no reflective 
surfaces and cannot be rotated. It is 
invulnerable to laser shots, how- 
ever, because it’s made of transpar- 
ent material—a laser beam passes 
right through it. Remember that. 
The beam splitter is another 
tricky piece. When a laser beam 
strikes a splitter’s vertex (the point 
opposite its base), the beam splits in 
two. The two new beams travel in 
opposite directions, perpendicular 
to the original beam’s path. When a 
laser shot hits one of the beam split- 
ter’s reflective surfaces, it bounces 
off at a 90-degree angle without 
splitting. If the beam splitter’s base 
is hit by a laser shot, it is destroyed. 
The beam splitter can be rotated. 
The blocks are fairly simple 
pieces. However, they may impose 
some complex situations. A block 
can capture any opposing piece by 
moving onto that piece’s square, 
much like a king. But unlike a king, 
a block has one reflective side and 
can be rotated as the situation de- 
mands. Therefore, blocks can be 
used either offensively or defen- 
sively. A laser beam that hits the 
reflective surface of a block is de- 
flected 180 degrees—bouncing the 
beam back where it came from. 
A diagonal mirror cannot be de- 
stroyed by a laser, because both of 
its surfaces are reflective. Diagonal 
mirrors can be removed from the 
board only when captured by a 
block or a king. When a laser beam 
strikes a diagonal mirror, the beam 
is deflected 90 degrees. Diagonal 
mirrors can be flipped to their oppo- 
site diagonal, but cannot be rotated 
to face horizontally or vertically. 
The horizontal mirrors and verti- 
cal mirrors (known collectively as 
straight mirrors) are also invulnera- 
ble to lasers due to their reflective 
surfaces. When a laser hits a straight 
mirror on its flat surface, the beam is 
deflected 180 degrees. If the laser 
hits a straight mirror edgewise, the 
beam passes straight through it. 
Straight mirrors can be rotated to 
become either horizontal or vertical 
mirrors, but not diagonal mirrors. 
The triangular mirrors deflect 
laser beams just as diagonal mirrors 
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do, but they are vulnerable to hits 
on their two nonreflective sides. A 
triangular mirror can be rotated in 
90-degree increments. 


Making Moves 

As in the conventional game of 
chess, a move in Laser Chess con- 
sists of moving or otherwise ma- 
nipulating a game piece. 

To move a piece, move the cur- 
sor onto the piece, press the fire 
button, and then move to the desti- 
nation square and press the button 
a second time. The cursor turns a 
darker color when a piece has been 
selected. 

The same player always moves 
first in Laser Chess. There’s no par- 
ticular advantage or disadvantage 
to moving first. 

A turn. consists of two moves. 
The number of moves remaining in 
a turn is indicated visually on the 
screen. 

If you accidentally select the 
wrong piece, you can deselect it by 
the same means used to select it, as 
long as you're still in the same 
square. Deselecting is usually done 
after rotating a piece—more on this 
in a moment. 

After you've selected a piece, 
your next decision is whether to 
move or rotate it. Moving a distance 
of one square takes one move; mov- 
ing two squares takes two moves 
(although you can move a piece two 
squares in one step). Since you have 
only two moves per turn, the maxi- 
mum distance a piece can be moved 
in one turn is two squares. The com- 
puter does not allow illegal moves. 

Pieces can be moved forward, 
backward, left, or right, but not di- 
agonally. You can effectively move 
a piece diagonally by using two 
moves—forward and right, for in- 
stance. 

You cannot move a piece onto 
a square occupied by another piece. 
The only exceptions are captures 
with blocks and kings, and moves 
of the hypercube as described above. 


Rotating A Piece 

To rotate a piece, move the cursor 
over the piece and press the button 
until the piece has rotated to the 
desired position. If you decide not 
to rotate the piece, keep pressing 
until the piece is not selected any 
more, The computer does not allow 





you to rotate a piece that’s incapa- 
ble of rotation. Otherwise, the piece 
rotates 90 degrees (one-quarter 
turn) clockwise. You may continue 
rotating the piece to any desired 
position before deselecting it by 
pressing the joystick in any direc- 
tion. Rotating a piece to face any 
direction takes only one move, and 
the move is subtracted after the 
piece is deselected. If you deselect 
the piece in its original position, no 
move is subtracted. 


Special Features 

At the center of the 9 X 9 board is a 
special square called a hypersquare. 
It absorbs laser beams and acts like a 
stationary hypercube. That is, if you 
try to move a piece onto it, the piece 
disappears from its original position 
and reappears on a randomly select- 
ed empty square. This can happen 
only once per turn, however. 

To quit the game, press System 
Reset; to quit the game and start a 
new game, press System Reset and 
enter RUN. 


Firing The Laser 
To fire the laser, move the cursor to 
the laser and press the button; then 
press L. Firing your laser takes only 
one move, but can be done only 
once per turn, Therefore, you may 
want to use your first move in a turn 
to aim the laser, rotate a reflecting 
piece to set up a bounce shot, or 
move another piece into position. 
Of course, you won't necessar- 
ily be firing the laser on every turn. 
Much of the strategy in Laser Chess 
involves moving and rotating your 
pieces to set up complex shots. It’s 
important to realize that any laser 
hit on a piece’s nonreflective or 
nontransparent surface will destroy 
that piece. You can destroy your 
own pieces just as easily as you can 
destroy your opponent’s. You can 
even zap your own laser, particu- 
larly if you fire directly into the 
180-degree reflective surface of a 
straight mirror or block, or if you 
fail to anticipate the effects of a 
beam splitter. Be forewarned. 


Laser Chess Strategy 

As in the conventional game of 
chess, much of the strategy in Laser 
Chess revolves around thoughtful 
placement of your pieces. However, 
the character of the game differs 








— 
from that of chess in many ways. 
The laser, for example, can strike at 
long distances and in more than 
one direction at once, And the hy- 
percube adds an extra element of 
uncertainty. The best strategy for 
any particular game depends to a 
great extent on the skill and person- 
ality of your opponent. However, 
here are some general tips you may 
find helpful. 

Get your mirrors out early. Use 
them to gain the fullest potential of 
your laser. Try to position mirror 
networks on both sides of the beam 
splitter so you can inflict as much 
damage as possible. 

Take advantage of the blocks. 
Since they “‘control’’ an area 
around them with their threat of 
capture, no other pieces can safely 
move within their range. Make 
your opponent work to displace 
them. Remember to rotate the re- 
flective side of a block to the most 
probable direction of laser fire. If 
you can prevent a laser from de- 
stroying the block, your opponent 
will most likely have to gang up on 
it with two or more of his or her 
own blocks, 

Use mirrors to protect your 
king. If you surround your king 
with straight and diagonal mirrors, 
there is no way it can be hit by a 
laser. Therefore, your opponent 
will have to break through your 
defense with blocks, (This is a pret- 
ty dirty trick, because when all of 
your opponent's blocks have been 
used, your king is almost invulnera- 
ble.) Defending your king with 
blocks is also a good strategy. 

The hypercube should be used 
sparingly, since you have no idea 
where a relocated piece will reap- 
pear. Most players use the hyper- 
cube as a last resort—if another 
piece is going to be destroyed any- 
way, it doesn’t hurt to take a chance 
and relocate it with the hypercube. 
Also, if your opponent's king is en- 
circled with mirrors, you can march 
right in with your hypercube, fol- 
lowed by a block. This tactic may 
displace your opponent's defense, 
forcing him to evacuate the king 
from its mirrored fortress. Escorting 
the hypercube with an adjacent 
block prevents the opponent from 
attacking the hypercube with his or 
her king. Your opponent's only op- 
tions will be to flee or be displaced.G 
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Nerm the worm is lost in Bemer Cas- 
tle and needs your help to get home. 
You must guide him through 11 rooms 
and help him find magic mushrooms 
to eat along the way. The journey is a 
navigator’s nightmare, because you 
never know where the next mushroom 
will grow, and if Nerm hits a wall or 
gets trapped by his tail, he loses one of 
his lives, Disk File: WORM.BAS. 


“Worm of Bemer” is a fast-paced 
arcade game in which Nerm the 
Worm travels through rooms eating 
magic mushrooms. Nerm is lost in 
Bemer Castle and wants to return 
home, Using the arrow keys, guide 
Nerm to a mushroom so he can 
keep up his strength for the jour- 
ney. After eating five mushrooms 
in a room, Nerm can exit to the next 
room. You must guide Nerm 
through 11 rooms before he finds 
his home. You start out with four 
lives, If you touch anything besides 
a mushroom you will lose a life. 

At the top of the screen will be 
the current score, what room Nerm 
is in, how many mushrooms Nerm 
must eat to open the exits, and how 
many lives Nerm has left, including 
the current life. You get 100 points, 
plus bonus points, for every mush- 
room you eat. Nerm gets a bonus 
life after completing the first two 
rooms and another for every third 
room thereafter. 


Special Features 

The game takes advantage of 
Atari’s graphic capabilities. Special 
features include custom-designed 
display lists, a display list interrupt, 





a redefined character set, and a spe- 
cial four-color graphics mode. 

Nerm uses four custom display 
lists. The most important display 
list is for the main screen. This dis- 
play list mixes three graphics 
modes on one screen. The first two 
display lines are in graphics mode 
2. The next ten lines are in a special 
graphics mode that allows four- 
color characters. The last part of the 
screen is in graphics mode 0. A 
display list interrupt is used to 
change the background color. The 
other three custom display lists mix 
modes 0, 1, and 2. 

A special character set was 
neeeded to take advantage of the 
four-color character graphics mode. 
Characters were redesigned for 
walls, the mushroom, and the body 
of Nerm. The original set was cop- 
ied to a location in memory not 
used by BASIC, and the new char- 
acters added. 

Worm of BEMER is written in 
BASIC with two machine language 
subroutines; one makes a fast copy 
of the character set, and the other is 
the dispay list interrupt. 


Adding More Features 

You can learn a lot about program- 
ming and games by modifying the 
action and settings in Worm of 
Bemer. Some features you might 
add include a routine to save the 
high score to disk, adding more 
players, or having Nerm go to a 
different room depending on which 
exit he takes. Simpler enhance- 
ments would be changing the num- 
ber of mushrooms that Nerm must 
eat or changing his speed. eS 
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SpeedScript has become one of the 
most popular word processors for the 
Commodore 64 and VIC-20. This ver- 
sion of the powerful program runs on 
all eight-bit Ataris with at least 24K, 
disk or cassette (including the 400/ 
800, 600XL/800XL, 1200XL, and XE 
series). SpeedScript compares favor- 
ably with commercial word proces- 
sors and has some features never seen 
before in an Atari word processor. 
Disk File: SS.COM. 


SpeedScript 3.0, though compact in 
size (8K), has many features found 
on commercial word processors. 
SpeedScript is also very easy to learn 
and use. You type in everything 
first; preview and make corrections 
on the screen; insert and delete 
words, sentences, and paragraphs; 
then print out an error-free draft, 
letting SpeedScript take care of 
things like margins, centering, 
headers, and footers. 

To use SpeedScript, you must 
copy it to a disk which also contains 
DOS.SYS and DUP.SYS. On your 
work disk, SpeedScript should be 
saved under the name AUTO- 
RUN.SYS; it will automatically load 
and run when you turn on your 
computer with this disk in the 
drive. (On the 600XL, 800XL, and 
XE series, disable BASIC by holding 
down OPTION when switching on 
the computer.) SpeedScript must al- 
ways be named AUTORUN.SYS in 
order to load properly with Atari 
DOS. If you want to prevent it from 
automatically running for some 
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reason, you can save it with another 
name, then rename it AUTO- 
RUN.SYS later. 

If you're using Optimized Sys- 
tem Software’s OS/A+ DOS or a 
compatible successor, you can give 
SpeedScript any filename you like. 
Just use the LOAD command from 
DOS, and SpeedScript will automat- 
ically run. Or you can give it a 
filename with the extension .COM, 
such as SPEED.COM. Then you 
can start up by just typing SPEED at 
the DOS prompt. You can also 
write a simple batch file to boot up 
SpeedScript automatically. 

Note: The AUTORUN.SYS file 
on your DOS master disk is respon- 
sible for booting up the 850 Inter- 
face Module for RS-232 commu- 
nications. There is no easy way to 
combine the 850 boot program with 
SpeedScript, so you can’t access the 
R: device. We'll show you later how 
to transfer files over a modem, or 
print to a serial printer. 


Entering Text / 

When you run SpeedScript, the 
screen colors change to black on 
white. The first line on the screen is 
black with white letters. SpeedScript 
presents all messages on this com- 
mand line. The remaining 18 lines 
of the screen are used to enter, edit, 
and display your document. Speed- 
Script makes use of a special but 
little-used Atari character mode 
that permits larger, more readable 
characters with true lowercase de- 
scenders. The screen still shows up 
to 40 columns; only five rows are 





SpeedsScript 3.0 


All Machine Language 
Word Processor For Ajiari 


sacrificed. We think you'll agree 
that this is the most readable text 
you've ever seen on an Atari—per- 
fect for word processing. (Technical 
note: SpeedScript starts at $1F00, 
and the ANTIC 3 character set is 
embedded at $2000.) 

The cursor, a blinking square, 
shows where the next character you 
type will appear on the screen. 
SpeedScript lets you move the cur- 
sor anywhere within your docu- 
ment, making it easy to find and 
correct errors. 

To begin using SpeedScript, just 
start typing. When the cursor 
reaches the right edge of the screen, 
it automatically jumps to the begin- 
ning of the next line, just as in 
BASIC. But unlike BASIC, Speed- 
Script never splits words at the right 
edge of the screen. If a word you're 
typing won’t fit at the end of one 
line, it’s instantly moved to the next 
line. This feature, called word-wrap 
or parsing, also helps to make your 
text more readable. 


Scrolling And 

Screen Formatting 

When you finish typing on the last 
screen line, SpeedScript automati- 
cally scrolls the text upward to 
make room for a new line at the 
bottom. Imagine the screen as an 
18-line window on a long, continu- 
ous document. If you’ve unplugged 
all cartridges or disabled BASIC as 
described above, there’s room in 
memory for 3328 characters of text 
with 24K RAM and up to 27,904 
characters on a 48K machine. (Un- 
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fortunately, SpeedScript 3.0 cannot 
make use of the extra memory 
available in the XL and XE series. 
To check at any time how much 
unused space is left, press CTRL-U 
(hold down the CTRL key while 
pressing the U key). The number 
appearing in the command line in- 
dicates how much unused room re- 
mains for characters of text. 

If you're used to a typewriter, 
you'll have to unlearn some habits 
if this is your first experience with 
word processing. Since the screen is 
only 40 columns wide, and most 
printers have 80-column carriages, 
it doesn’t make sense to press RE- 
TURN at the end of each line as you 
do on a typewriter. SpeedScript’s 
word-wrap takes care of this auto- 
matically. Press RETURN only 
when you want to force a carriage 
return to end a paragraph or limit 
the length of a line. A return-mark 
appears on the screen as a crooked 
left-pointing arrow. 


Using The Keyboard 

Most features are accessed with 
control-key commands—you hold 
down CTRL while pressing another 
key. In this article, control-key 
commands are abbreviated CTRL-x 
(where x is the key you press in 
combination with CTRL). An ex- 
ample is the CTRL-U mentioned 
above to check on unused memory. 
CTRL-E means: hold down CTRL 
and press E. Sometimes you must 
also hold down the OPTION but- 
ton to select a special option of a 
command, such as OPTION-CTRL- 
H. Other keys are referenced by 
name or function, such as DELETE/ 
BACK S for the backspace key, 
CTRL-CLEAR for the clear screen 
key, and cursor left or CTRL-+ for 
the cursor left key. See the figure for 
a complete quick-reference chart of 
all keyboard commands. 

Some keys let you move the 
cursor to different places in the doc- 
ument to make corrections or scroll 
text into view. You can move the 
cursor by character, word, sen- 
tence, or paragraph. Here’s how to 
control the cursor: 


¢ The cursor left/right keys 
(CTRL-+ and CTRL-*) work as 
usual; pressing CTRL-* moves the 
cursor right (forward) one space, 
and CTRL-+ moves the cursor left 
(backward) one space. 





¢ The cursor up/down keys 
(CTRL-minus and CTRL-=) move 
the cursor to the beginning of either 
the next or previous sentence. Press 
CTRL-minus to move the cursor 
up (backward) to the beginning of 
the previous sentence. Press 
CTRL-= to move the cursor down 
(forward) to the beginning of the 
next sentence. 

¢ SHIFT-+ moves the cursor 
left (backward) to the beginning of 
the previous word. SHIFT-* moves 
the cursor right (forward) to the 
beginning of the next word. If you 
get confused, just look at the arrows 
on the keys for a reminder. 


* SHIFT-minus moves the cur- 
sor up (backward) to the beginning 
of the previous paragraph, SHIFT-= 
moves the cursor down (forward) to 
the beginning of the next para- 
graph. Again, look at the arrows on 
these keys for a reminder. A para- 
graph always ends with a return- 
mark. 

« The START button, pressed 
once, moves the cursor to the top 
(start) of the screen without scroll- 
ing. Pressed twice, it moves the cur- 
sor to the start of the document. 

¢ CTRL-Z moves the cursor to 
the end of the document, scrolling 
if necessary. It’s easy to remember 
since Z is at the end of the alphabet. 


For special applications, if you 
ever need to type the actual charac- 
ter represented by a command or 
cursor key, press ESC before typing 
the CTRL key. Press ESC twice to 
get the ESCape character, CHR$(27). 


Correcting Your Typing 
Sometimes you'll have to insert 
some characters to make a correc- 
tion. Use CTRL-INSERT to open 
up a single space, just as in BASIC. 
Merely position the cursor at the 
point where you want to insert a 
space, and press CTRL-INSERT. 

It can be tedious to use CTRL- 
INSERT to open up enough space 
for a whole sentence or paragraph. 
For convenience, SpeedScript has an 
insert mode that automatically in- 
serts space for each character you 
type. In this mode, you can’t type 
over characters; everything is in- 
serted at the cursor position. To 
enter insert mode, press CTRL-I. 
To cancel insert mode, press CTRL-I 
again. To let you know you're in 





insert mode, the black command line 
at the top of the screen turns blue. 

Insert mode is the easiest way 
to insert text, but it can become too 
slow when inserting near the top of 
a very long document because it 
must move all the text following the 
cursor position. So SpeedScript has 
even more ways to insert blocks of 
text. 

One way is to use the TAB key. 
It is programmed in SpeedScript to 
act as a five-space margin indent. To 
end a paragraph and start another, 
press RETURN twice and _ press 
TAB. TAB always inserts; you don’t 
need to be in insert mode. You can 
also use TAB to open up more space 
than CTRL-INSERT. (You cannot 
set or clear tab stops in SpeedScript 
as you can with the normal screen 
editor.) No matter how much space 
you want to insert, each insertion 
takes the same amount of time. So 
the TAB key can insert five spaces 
five times faster than pressing 
CTRL-INSERT five times. 

There’s an even better way, 
though. Press SHIFT-INSERT to 
insert 255 spaces (it does not insert 
a line; use RETURN for that). You 
can press it several times to open up 
as much space as you need. And 
SHIFT-INSERT is fast. It inserts 255 
spaces as fast as CTRL-INSERT 
opens up one space. Now just type 
the text you wanted to insert over 
the blank space. (You don’t want to 
be in CTRL-I insert mode when you 
use this trick; that would defeat its 
purpose.) 

Since the DELETE/BACK S 
key (backspace) is also slow when 
working with large documents (it, 
too, must move all text following 
the cursor), you may prefer to use 
the cursor-left key to backspace 
when using this method. 

After you're done inserting, 
there may be some inserted spaces 
left over that you didn’t use. Just 
press SHIFT-DELETE/BACK S. 
This instantly deletes all extra 
spaces between the cursor and the 
start of following text. It’s also use- 
ful whenever you need to delete a 
block of spaces for some reason. 


Erasing Text 

Press DELETE/BACK S by itself to 
erase the character to the left of the 
cursor, All the following text is 
pulled back to fill the vacant space. 
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Press CTRL-DELETE/BACK 
S to delete the character on which 
the cursor is sitting. Again, all the 
following text is moved toward the 
cursor to fill the empty space. 

These keys are fine for minor 
deletions, but it could take all day 
to delete a whole paragraph this 
way. So SpeedScript has two com- 
mands that can delete an entire 
word, sentence, or paragraph at a 
time. CTRL-E erases text after (to 





the right of) the cursor position, and 
CTRL-D deletes text behind (to the 
left of) the cursor. 

To use the CTRL-E erase 
mode, first place the cursor at the 
beginning of the word, sentence, or 
paragraph you want to erase. Then 
press CTRL-E. The command line 
shows the message “Erase.(S,W,P): 
RETURN to exit.” Press S to erase a 
sentence, W for a word, or P for a 
paragraph. Each time you press one 





of these letters, the text is quickly 
erased. You can keep pressing S, W, 
or P until you've erased all the text 
you wish. Then press RETURN to 
exit the erase mode. 

The CTRL-D delete mode 
works similarly, but deletes only 
one word, sentence, or paragraph at 
a time. First, place the cursor after 
the word, sentence, or paragraph 
you want to delete. Then press 
CTRL-D, Next, press S, W, or P for 
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sentence, word, or paragraph. The 
text is immediately deleted and you 
return to editing. You don’t need to 
press RETURN to exit the CTRL-D 
delete mode unless you pressed this 
key by mistake. (In general, you can 
escape from any command in Speed- 
Script by simply pressing RETURN.) 
CTRL-D is most convenient when 
the cursor is already past what 
you've been typing. 


The Text Buffer 
When you erase or delete with 
CTRL-E and CTRL-D, the text isn’t 
lost forever. SpeedScript remembers 
what you’ve removed by storing 
deletions in a separate area of mem- 
ory called a buffer. The buffer is a 
failsafe device. If you erase too 
much, or change your mind, just 
press CTRL-R to restore the dele- 
tion. However, be aware that 
SpeedScript remembers only the last 
erase or delete you performed. 
Another, more powerful, use 
of this buffer is to move or copy 
sections of text. To move some text 
from one location in your docu- 
ment to another, first erase or delete 
it with CTRL-E or CTRL-D. Then 
move the cursor to where you want 
the text to appear and press CTRL- 
R. CTRL-R instantly inserts the 
contents of the buffer at the cursor 
position. If you want to copy some 
text from one part of your docu- 
ment to another, just erase or delete 
it with CTRL-E or CTRL-D, restore 
it at the original position with 
CTRL-R, then move the cursor else- 
where and press CTRL-R to restore 
it again. You can retrieve the buffer 
with CTRL-R as many times as you 
like. If there is no room left in mem- 
ory for inserting the buffer, you'll 
see the message “Memory Full.” 


Important: The CTRL-E erase 
mode lets you erase up to the maxi- 
mum size of the buffer (2K disk), 
and CTRL-E also removes the pre- 
vious contents of the buffer. Keep 
this in mind if there’s something in 
the buffer you’d rather keep. If you 
don’t want the buffer to be erased, 
hold down the OPTION key while 
you press CTRL-E. This preserves 
the buffer contents and adds newly 
erased text to the buffer. 

If you ever need to erase the 
contents of the buffer, press CTRL-K 
(kill buffer). 











The Wastebasket 
Command 

If you want to start a new document, 
or simply obliterate all your text, 
hold down OPTION while you 
press SHIFT-CLEAR (that’s not a 
combination you're likely to press 
accidentally). SpeedScript asks, 
“ERASE ALL TEXT: Are you sure? 
(Y/N).” This is your last chance. If 
you don’t want to erase the entire 
document, press N or any other key. 
Press Y to perform the irreversible 
deed. There is no way to recover text 
wiped out with Erase All. 


Search And Replace 
SpeedScript has a Find command 
that searches through your docu- 
ment to find a selected word or 
phrase. A Change option lets you 
automatically change one word to 
another throughout the document. 

OPTION-CTRL-F (find) acti- 
vates the search feature, OPTION- 
CTRL-C (change) lets you selec- 
tively search and replace, and 
CTRL-G (global) is for automatical- 
ly searching and replacing. 

Searching is a two-step pro- 
cess. First you need to tell Speed- 
Script what to search for, then you 
trigger the actual search. Hold 
down OPTION and press CTRL-F. 
The command line prompts 
“Find:’’. Type in what you’d like to 
search for, the search phrase. If you 
press RETURN alone without typ- 
ing anything, the Find command is 
canceled. 

When you are ready to search, 
press CTRL-F. SpeedScript looks for 
the next occurrence of the search 
phrase starting from the current cur- 
sor position. If you want to hunt 
through the entire document, press 
START twice to move the cursor to 
the very top before beginning the 
search. Each time you press CTRL- 
F, SpeedScript looks for the next oc- 
currence of the search phrase and 
places the cursor at the start of the 
phrase. If the search fails, you'll see 
the message ‘’Not Found.” 

CTRL-C works together with 
CTRL-F. After you've specified the 
search phrase with OPTION- 
CTRL-F, press OPTION-CTRL-C 
to select the replace phrase. (You 
can press RETURN alone at the 
“Change to: prompt to select a 
null replace phrase. When you hunt 








and replace, this deletes the located 
phrase.) To manually search and 
replace, start by pressing CTRL-F. 
After SpeedScript finds the search 
phrase, press CTRL-C if you want 
to replace the phrase. If you don’t 
want to replace the phrase, don’t 
press CTRL-C. You are not in a 
special search and replace mode. 
You're free to continue writing at 
any time. 

CTRL-G links CTRL-F and 
CTRL-C together. It first asks 
“Find:”, then “Change to:”, then 
automatically searches and replaces 
throughout the document starting 
at the cursor position. 

There are a few things to watch 
out for when using search and re- 
place. First, realize that if you 
search for “the,” SpeedScript finds 
the embedded ‘‘the” in words like 
“therefore” and “heathen.” If you 
changed all occurrences of “the” to 
“cow,” these words would become 
“cowrefore’”’ and ‘‘heacown.” If 
you want to find a single word, 
include a space as the first character 
of the word, since almost all words 
are preceded by a space. Naturally, 
if you are replacing, you need to 
include the space in the replace 
phrase, too. 

Also, SpeedScript distinguishes 
between upper- and lowercase. The 
word ‘Meldids’” does not match 
with “meldids.” SpeedScript will not 
find a capitalized word unless you 
capitalize it in the search phrase. To 
cover all bases, you will sometimes 
need to make two passes at replac- 
ing a word. Keep these things in 
mind when using CTRL-G, since 
you don’t have a chance to stop a 
global search and replace. 





Storing Your Document 
Just press CTRL-S to store a docu- 
ment. You'll see the prompt “Save: 
(Device:Filename)>”. Type C: for 
cassette or D: plus a legal Atari file- 
name for disk. If you use the same 
name as a file already on disk, that 
file will be replaced by the new one. 
CTRL-S always saves the entire doc- 
ument. The cursor position within 
the document is not important. 
When the SAVE is complete, 
SpeedScript reports “No errors’ if 
all is well, or gives a message like 
“Error #144” if not. Check your 
DOS or BASIC manual for a list of 
error numbers and their causes. 
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Loading A Document 

To recall a previously saved docu- 
ment, press CTRL-L. Answer the 
“Load: (Device:Filename)>”’ 
prompt with the filename. Again, 
remember to include the C: for cas- 
sette or D: for disk. SpeedScript 
loads the file and should display 
“No errors.” Otherwise, Speed- 
Script reports the error number. 

The position of the cursor is im- 
portant before loading a file. Docu- 
ments start loading at the cursor 
position, so be sure to press START 
twice or OPTION-SHIFT-CLEAR 
(Erase All) to move the cursor to the 
start of text, unless you want to 
merge two documents. When you 
press CTRL-L to load, the com- 
mand line turns green to warn you 
if the cursor is not at the top of the 
document. 

To merge two or more files, 
simply load the first file, press 
CTRL-Z to move the cursor to the 
end of the document, and then load 
the file you want to merge. Do not 
place the cursor somewhere in the 
middle of your document before 
loading. A Load does not insert the 
text from tape or disk, but over- 
writes all text after the cursor posi- 
tion. The last character loaded 
becomes the new end-of-text point- 
er, and you cannot access any text 
that appears ahead of this pointer. 

Since SpeedScript stores files in 
ASCII (American Standard Code 
for Information Interchange), you 
can load any ASCII file with Speed- 
Script. You could write a BASIC 
program with SpeedScript, save it 
on disk, then use ENTER to read 
the file from BASIC. In BASIC, you 
can store a program in ASCII form 
with LIST “D:filename” for disk or 
LIST “C:’” for tape, ready to load 
with SpeedScript. You can even load 
files produced by most other word 
processors, and most word proces- 
sors can read SpeedScript files. You 
can make full use of SpeedScript’s 
editing features to prepare ASCII 
files for the Atari Assembler/Editor, 
MAC/65, and most other Atari as- 
semblers. And SpeedScript files can 
be transferred via modem with 
your favorite telecommunications 
program that handles ASCII. 


Disk Commands 
Sometimes you forget the name of a 
file, or need to delete or rename a 








file. SpeedScript provides a unique 
mini-DOS for your convenience. 
Just press CTRL-M (menu). Speed- 
Script reads the entire disk directory 
and puts it on the screen in three 
columns. A large cursor shows you 
which file is currently selected. Use 
the cursor keys to move the cursor 
to the file you want to select. A 
menu at the bottom of the screen 
shows you what keys you need to 
press. Press CTRL-D to delete the 
selected file, R to rename, L to lock, 
U to unlock, or F to format the disk. 
You can load the selected file by 
pressing CTRL-L. The position of 
the cursor within your document is 
not important when loading a file 
from the menu—SpeedScript always 
erases anything you previously had 
in memory. 

Any changes you make to the 
directory will not show up until you 
call up the directory again. Press 
either 1, 2, 3, or 4 to update the 
directory from drive 1-4. This also 
sets the default disk drive, the drive 
accessed for further changes. When 
you're ready to return to writing, 
press either ESC or the RETURN 
key. 


Additional Features 
SpeedScript has a few commands 
that don’t do much, but are nice to 
have. CTRL-X exchanges the char- 
acter under the cursor with the 
character to the right of the cursor. 
Thus you can fix transposition errors 
with a single keystroke. CTRL-A 
changes the character under the 
cursor from uppercase to lowercase 
or vice versa. 

Press CTRL-B to change the 
background and border colors. 
Each time you press CTRL-B, one of 
128 different background colors ap- 
pears. Press CTRL-T (text) to cycle 
between one of eight text lumin- 
ances. The colors are preserved un- 
til you change them or reboot 
SpeedScript. 

If your TV suffers from over- 
scanning, some characters on the 
left or right margin may be chopped 
off. Atari SpeedScript lets you widen 
and narrow the width of the screen. 
Press OPTION-CTRL-+ (the cur- 
sor left key) to decrease the width 
of the screen. Each time you press 
it, the text is reformatted, and the 
left and right screen margins are 
adjusted by one character. You can 
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decrease the width all the way 
down to two characters (although if 
your screen overscans that much, 
it’s time to buy a new TV). To in- 
crease the width, up to a maximum 
of 40 (the default width), press 
OPTION-CTRL-* (the cursor right 
key). 

One disadvantage of word- 
wrapping is that it’s hard to tell 
exactly how many spaces are at the 
end of a screen line. When a word 
too long to fit on a line is wrapped 
to the next line, the hole it left is 
filled with ‘‘false’’ spaces. That is, 
the spaces are not actually part of 
your text, and won’t appear on pa- 
pér. If you want to distinguish be- 
tween true spaces and false spaces, 
press CTRL-O (on/off), The false 
spaces become tiny dots. You can 
write and edit in this mode if you 
wish, or turn off the feature by 
pressing CTRL-O again. 

Atari SpeedScript disables the 
BREAK and inverse video keys 
when you're entering or editing text. 
The inverse video key was disabled 
because it is frequently pressed by 
accident on the 800 and 800XL 
models. If you want to enter inverse 
video characters, hold down SE- 
LECT while typing the keys. 

Atari 400 and 800 owners will 
notice that the action of the CAPS/ 
LOWR key has been changed in 
SpeedScript. It works like the CAPS 
key on the XL and XE models. Press 
it once to switch to uppercase, and 
again to switch to lowercase. In oth- 
er words, the CAPS/LOWR key 
toggles between upper- and lower- 
case. You can still use SHIFT- 
CAPS/LOWR to force entry to all 
uppercase. CTRL-CAPS/LOWR 
has no effect. 

Pressing SYSTEM RESET re- 
turns you to SpeedScript without 
erasing your text when using Atari 
DOS. With OS/A+ DOS, SYSTEM 
RESET returns you to the DOS 
command prompt. You can get 
back to SpeedScript without losing 
any text if you type RUN at the 
prompt. 


PRINT! 

If you already think SpeedScript has 
plenty of commands, wait until you 
see what the printing package of- 
fers. SpeedScript supports an array 
of powerful formatting features. It 
automatically fits your text between 











left and right margins you can spec- 
ify. You can center a line or block it 
against the right margin. Speed- 
Script skips over the perforation on 
continuous-form paper, or can wait 
for you to insert single-sheet paper. 
A line of text can be printed at the 
top of each page (a header) and/or 
at the bottom of each page (a foot- 
er), and can include automatic page 
numbering, starting with whatever 
number you like. 

SpeedScript can print on differ- 
ent lengths and widths of paper, and 
single-, double-, triple-, or any- 
spacing is easy. You can print a doc- 
ument as big as can fit on a tape or 
disk by linking several files together 
during printing. You can print to the 
screen or to a file instead of to a 
printer. Other features let you send 
special codes to the printer to con- 
trol features like underlining, bold- 
facing, and double-width type 
(depending on the printer). 

But with all this power comes 
the need to learn additional com- 
mands. Fortunately, SpeedScript 
sets most of these variables to a 
default state. If you don’t change 
these settings, SpeedScript assumes 
a left margin of five, a right margin 
position of 75, no header or footer, 
single-spacing, and continuous- 
paper page feeding. You can 
change these default settings if you 
want (see below), Before printing, 
be sure the paper in your printer is 
adjusted to top-of-form (move the 
paper perforation just above the 
printing element). One additional 
note: Some printers incorporate an 
automatic skip-over-perforation 
feature. The printer skips to the 
next page when it reaches the bot- 
tom of a page. Since SpeedScript 
already controls paper feeding, you 
need to turn off this automatic skip- 
over-perf feature before running 
SpeedScript, or paging won't work 
properly. 

To begin printing, simply press 
CTRL-P. SpeedScript prompts 
“Print: (Device:Filename)>”. You 
can print to almost any device, even 
disk or cassette. If you enter E (for 
Editor), SpeedScript prints to the 
screen, letting you preview where 
lines and pages break. Enter P to 
Print for most printers. If your 
printer is attached, powered on, 
and selected (online), SpeedScript 
begins printing immediately. To 





cancel printing, hold down the 
BREAK key until printing stops. 
You can use CTRL-1 to pause 
printing. Press CTRL-1 again to 
continue. 

If you need to print to an RS- 
232 printer, just Print to a disk file, 
then boot up your DOS master disk 
and use the copy selection to copy 
the print file to the R: device. You 
can.also write BASIC programs to 
read and process a Printed disk file. 
Remember, a Print to disk is not the 
same as a Save to disk. 


Formatting Commands 
The print formatting commands 
must be distinguished from normal 
text, so they appear on-screen in 
inverse video with the text and 
background colors switched. As 
mentioned above, the regular in- 
verse video key is not used for enter- 
ing inverse video text. Instead, hold 
down the SELECT key while typing 
the format key. All lettered printer 
commands should be entered in 
lowercase (unSHIFTed). During 
printing, SpeedScript treats these 
characters as printing commands. 
There are two kinds of printing 
commands, which we'll call Stage 1 
and Stage 2. Stage 1 commands 
usually control variables such as 
left margin and right margin. Most 
are followed by a number, with no 
space between the command and 
the number. Stage 1 commands are 
executed before a line is printed. 
Stage 2 commands, like center- 
ing and underlining, are executed 
while the line is being printed. 
Usually Stage 1 commands must be 
ona line of their own, although you 
can group several Stage 1 com- 
mands together on a line. Stage 2 
commands are by nature embedded 
within a line of text. Again, remem- 
ber to hold down SELECT to enter 
the boldface characters shown here. 


Stage 1 Commands 

1 Left margin. Follow with a 
number from 0 to 255. Use 0 for no 
margin. Defaults to 5. 

t Right margin position, a 
number from 1 to 255, Defaults to 
75. Be sure the right margin value is 
greater than the left margin value, 
or SpeedScript will go bonkers. 

t Top margin. The position at 
which the first line of text is printed, 
relative to the top of the page. De- 





faults to 5. The header (if any) is 
always printed on the first line of 
the page, before the first line of text. 


b Bottom margin. The line at 
which printing stops before con- 
tinuing to the next page. Standard 
82 X 11-inch paper has 66 lines. 
Bottom margin defaults to the fifty- 
eighth line. Don’t make the bottom 
margin greater than the page length. 


p Page length. Defaults to 66. 
If your printer does not print six 
lines per inch, multiply lines-per- 
inch by 11 to get the page length. 
European paper is usually longer 
than American paper—11% or 12 
inches. Try a page length of 69 or 72. 


s Spacing. Defaults to single- 
spacing. Follow with a number 
from 1 to 255. Use 1 for single- 
spacing, 2 for double-spacing, 3 for 
triple-spacing. 

@ Start numbering at page 
number given. Page numbering 
normally starts with 1. 


? Disables printing until select- 
ed page number is reached. For ex- 
ample, a value of 3 would start 
printing the third page of your doc- 
ument. Normally, SpeedScript 
prints starting with the first page. 


x Sets the page width, in col- 
umns (think a cross), Defaults to 80. 
You need to change this for the sake 
of the centering command if you 
are printing in double-width or 
condensed type, or are using a 40- 
column or wide-carriage printer. 


n Forced paging. Normally, 
SpeedScript prints the footer and 
moves on to the next page only 
when it has finished a page, but you 
can force it to continue to the next 
page by issuing this command. It 
requires no numbers. 


m Margin release. Disables the 
left margin for the next printed line. 
Remember that this executes before 
the line is printed. It’s used for 
outdenting. 

w Page wait. This command 
should be placed at the beginning 
of your document before any text. 
With page wait turned on, Speed- 
Script prompts you to “Insert next 
sheet, press RETURN” when each 
page is finished printing. Insert the 
next sheet, line it up with the print- 
head, then press RETURN to con- 
tinue. Page wait is ignored during 
disk or screen output. 
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j Select automatic linefeeds 


command at the beginning of every 


after carriage return. Like w, this 
command must be placed before 
any text. Don’t use this command 
to achieve double-spacing, but only 
if all text prints on the same line. 


i Information. This works like 
REM in BASIC. You follow the 
command with a line of text, up to 
255 characters, ending in a return- 
mark. This line will be ignored 
during printing, and is handy for 
making notes to yourself such as 
the filename of the document. 

h Header define and enable. 
The header must be a single line of 
text (up to 254 characters) ending in 
a return-mark. The header prints on 
the first line of each page. You can 
include Stage 2 commands such as 
centering and page numbering in a 
header. You can use a header by 
itself without a footer. The header 
and footer should be defined at the 
top of your document, before any 
text. If you want to prevent the 
header from printing on the first 
page, put a return-mark by itself at 
the top of your document before 
the header definition. 

f Footer define and enable. The 
footer must be a single line of text 
(up to 254 characters) ending in a 
return-mark. The footer prints two 
lines prior to the last line of each 
page. As with the header, you can 
include Stage 2 printing com- 
mands, and you don’t need to set 
the header to use a footer. 

g Go to (link) next file. Put this 
command as the last line in your 
document. Follow the command 
with the filename, including D: for 
disk. After the text in memory is 
printed, the link command loads 
the next file into memory. You can 
continue linking in successive files, 
but don’t include a link in the last 
file, Before you start printing a 
linked file, make sure the first of the 
linked files is in memory. When 
printing is finished, the last file 
linked to will be in memory. 


Stage 2 Commands 

These commands either precede a 
line of text, or are embedded within 
one. 


c Centering. Put this at the be- 
ginning of a line you want to center. 
This will center only one line end- 

ing in a return-mark. Repeat this 
—— 








line you want centered. Centering 
uses the page-width setting (see 
above) to properly center the line. 
To center a double-width line, 
either set the page width to 40 or 
pad out the rest of the line with an 
equal number of spaces. If you use 
double width, remember that the 
spaces preceding the centered text 
will be double-wide spaces. 

# When SpeedScript encoun- 
ters this command, it prints the cur- 
rent page number. You usually 
embed this within a header or footer. 

u A simple form of underlin- 
ing. It works only on printers that 
recognize CHR$(8) as a backspace 
and CHR$(95) as an underline 
character. Underlining works on 
spaces, too. Use the first u to start 
underlining, and another one to 
turn off underlining. 


Fonts And Styles 

Most dot-matrix printers are capa- 
ble of more than just printing text at 
ten characters per inch. Some print- 
ers have several character sets, with 
italics and foreign language charac- 
ters. Most can print in double width 
(40 characters per line), condensed 
(132 characters per jine), and in 
either pica or elite. Other features 
include programmable characters, 
programmable tab stops, and 
graphics modes. Many word pro- 
cessors customize themselves to a 
particular printer, but SpeedScript 
was purposely designed not to be 
printer-specific. Instead, Speed- 
Script lets you define your own 
Stage 2 printing commands. 

You define a programmable 
printkey by choosing any character 
that is not already used for other 
printer commands. The entire up- 
percase alphabet is available for 
printkeys, and you can choose let- 
ters that are related to their function 
(like D for double width). You enter 
these commands like printer com- 
mands, by holding down SELECT 
while you type them. The printkeys 
are like variables in BASIC. 

To define a printkey, just hold 
down SELECT while you type the 
key you want to assign as the print- 
key, then an equals sign (=), and 
finally the ASCII value to be substi- 
tuted for the printkey ‘during print- 
ing. Now whenever SpeedScript 
encounters the printkey embedded 





in text, it prints the character with 
the ASCII value you previously 
defined. 

For example, to define the + 
key as the letter z, you first look up 
the ASCII value of the letter z (in 
either your printer manual or in any 
Atari manual). The ASCII value of 
the letter z is 122, so the definition is: 


Hi=123. 


Now, anywhere you want to print 
the letter z, substitute the printkey: 
GadffJjooks! The Hoo is Hjany! 

This would appear on paper as: 
Gadzooks! The zoo is zany! 

More practically, here’s how 
you could program italics on an 
Epson MX-80 compatible printer. 
You switch on italics by sending an 
ESC (a character with an ASCII val- 
ue of 27), then the character 4. You 
turn off italics by sending ESC 5. So 
define SHIFT-E as the escape code. 
Anywhere you want to print a word 
in italics, bracket it with printkey E 
then 4 and printkey E then 5: 

The word [iitalics§5 is in italics. 

You can similarly define what- 
ever codes your printer uses for fea- 
tures like double-width or 
emphasized mode. For your 
convenience, four of the printkeys 
are predefined, though you can 
change them. The keys 1-4 are de- 
fined as 27, 14, 15, and 18, common 
values for most printers. On most 
printers, CHR$(27) is the ESCape 
key, CHR$(14) starts double-width, 
CHR$(15) either stops double- 
width or starts condensed charac- 
ters, and CHR$(18) usually cancels 
condensed characters. 

SpeedScript actually lets you 
embed any character within text, so 
you may prefer to put in the actual 
printer codes as part of your text. To 
set italics, you could just press ESC 
twice, then 4. The ESC key appears 
in text as a mutant E. Double-width 
has a value of 14, the same value as 
CTRL-N. To start double width, 
just embed a CTRL-N. Remember 
that you must press ESC before any 
CTRL key to get it to appear in text. 
CTRL keys appear as small “‘shad- 
owed” capital letters. These charac- 
ters, though, are counted as part of 
the length of a line, and excessive 
use within one line can result in a 
shorter than normal line. It can be 
more convenient to use the print- 
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keys, since if you ever change print- 
ers, you have to change only the 
definitions of the keys. 

Keep one thing in mind about 
printkeys. SpeedScript always as- 
sumes it is printing to a rather 
dumb, featureless printer, the least 
common denominator. SpeedScript 
doesn’t understand the intent of a 
printkey; it justs sends out its value. 
So if you make one word within a 
line double-width, it may make the 
line overflow the specified right 
margin. There’s no way for Speed- 
Script to include built-in font and 
typestyle codes without being cus- 
tomized for a particular printer, 
since no set of codes is universal to 
all printers. 


Hints And Tips 
It may take you awhile to fully mas- 
ter SpeedScript, but as you do you'll 
discover many ways to use the edit- 
ing and formatting commands. For 
example, there is a simple way to 
simulate tab stops, say for a colum- 
nar table. Just type a period at every 
tab stop position. Erase the line 
with CTRL-E, then restore it with 
CTRL-R multiple times. When you 
are filling in the table, just use word 
left/word right to jump quickly be- 
tween the periods. Or you can use 
the programmable printkeys to em- 
bed your printer’s own commands 
for setting and jumping to tab stops. 
You don’t have to change or 
define printer commands every 
time you write. Just save these defi- 
nitions, and load this file each time 
you write. You can create many 
custom definition files and have 
them ready to use on disk. You can 
create customized ‘‘fill-in-the- 
blank” letters. Just type the letter, 
and everywhere you'll need to in- 
sert something, substitute a unique 
character, such as an * or a CTRL 
character. When you're ready to 
customize the letter, use Find to 
locate each symbol and insert the 
specific information. Instead of typ- 
ing an oft-used word or phrase, 
substitute a unique character, then 
use CTRL-G to globally change 
these characters into the actual 
word or phrase. You can even use 
SpeedScript as a simple filing pro- 
gram. Just type in all your data, 
flagging each field with a unique 
character. You can use Find to 
quickly locate any field. (os 





Atari 


SpeedScript 
Customizer 


David S. Bryant 


This short utility allows Atari users to 
easily personalize SpeedScript 3.0. 
Disk File: SSCUSTOM.BAS. 


This menu-driven program makes 
it possible to customize Atari Speed- 
Script 3.0 for your personal use. 
Using a convenient, onscreen 
menu, you can choose new screen 
colors or change the default disk 
drive, a feature that’s very useful 
for 130XE owners. 

When you run the program, an 
introduction screen appears. Press 
the space bar to continue to the first 
menu. Select one of the four choices 
by pressing the correct numeric 
key. Press 1 for screen changes, 2 
for both changes, or 3 for the RAM- 
disk change alone, Press 4 to return 
to BASIC. 

If you choose options 1 or 2, 
the program displays screens de- 
scribing the method for selecting 
colors. To change the border color, 
enter a number from 0 to 127. Fol- 
lowing is a list of possible values 
and their colors: 


Black 0 
Rust 8 
Red 32 
Cobalt 48 
Green 88 
Orange 120 


You will also be prompted to 
enter a number from 0-7 for the text 








luminance value. A 0 represents the 
lowest luminance value (dark text), 
and 7 the highest value (bright text). 
The screen changes to show your 
choices. If no text is visible, you 
have set both text and border lumi- 
nance at the same values, Press Y to 
confirm the choices when you are 
satisfied with the colors. 

To change the default disk 
drive, make sure that the file RAM- 
DISK.COM is on the current disk. 
The available drives in the disk com- 
mand menu are changed to 1, 2, 3, 
and 8 (drive 8 has been exchanged 
with drive 4). You may not use the F 
option to format drive 8; however, 
all other features work as usual. 

After you make your selections, 
insert the disk which contains a 
copy of SpeedScript 3.0. (You should 
make the changes on a copy of 
SpeedScript, not the original pro- 
gram.) Enter the filename under 
which SpeedScript was saved and 
press RETURN. The program reads 
the file into memory, then prompts 
you to insert a formatted disk and 
press the space bar. The program 
ends by returning you to BASIC 
ready mode. To prevent filename 
conflicts, the customized version of 
SpeedScript is given the filename 
SCRIPT30.BAK. To use the pro- 
gram, perform a binary load from 
DOS or rename the file AUTO- 
RUN.SYS and reboot the system. © 

—} 
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Written completely in high-speed ma- 
chine language, Atari SpeedCalc has 
all the important features you'd ex- 
pect from a commercial spreadsheet 
program. In addition, its data files can 
be merged into text files created with 
Atari SpeedScript. Atari SpeedCalc 
requires a disk drive, and a printer is 
optional but recommended. Disk File: 
SPCALC.OB]J. 


Have you ever planned a budget for 
your home or office? If so, you prob- 
ably used some sort of worksheet 
divided into rows and columns. Per- 
haps you wrote the months of the 
year along the top of the sheet and 
listed categories for earnings and ex- 
penses along one side. After enter- 
ing data for each category and 
month of the year, you could calcu- 
late total income figures by adding 
or subtracting numbers in each of 
the sheet’s “cells.” 

That's a classic example of a 
worksheet. It lets you enter and 
organize data, then perform calcu- 
lations that produce new infor- 
mation. A spreadsheet program is an 
electronic version of the familiar 
paper worksheet. Since it does all 
the calculations for you at lightning 
speed, an electronic spreadsheet is 
far more convenient than its paper 
counterpart. And spreadsheet pro- 
grams also offer editing features 
that let you enter and manipulate 
large amounts of data with a mini- 
mum of effort. 

Atari SpeedCalc is an all ma- 
chine language spreadsheet pro- 
gram for Atari 400, 800, XL, and XE 
computers with at least 48K RAM. 
Though relatively compact in size, 
SpeedCalc is fast, easy to use, and 
has many of the features found in 
commercial spreadsheet programs. 








Even better, if you print a SpeedCalc 
file to disk (see below), you can then 
merge it with a word processing 
document created with SpeedScript. 

Working together, SpeedCalc 
and SpeedScript make a powerful 
team. You can merge a chart of 
sales figures into a company report, 
create a table of scientific data for a 
term paper, and manipulate numer- 
ic information in many other ways. 
In a sense, a spreadsheet program 
brings to arithmetic all of the flexi- 
bility and power that a word pro- 
cessor brings to writing. 

Because SpeedCalc requires a 
full 48K of RAM in order to work, 
you must always disable BASIC 
before loading or running SpeedCalc. 
On an Atari 400, 800, or 1200XL, 
unplug the BASIC cartridge (or any 
other cartridge, for that matter), On 
an Atari 600XL, 800XL, or 130XE, 
unplug any cartridges and disable 
BASIC by holding down the OP- 
TION button when you first switch 
on and boot the computer. If you 
forget to disable BASIC, SpeedCalc 
won't work correctly. 

To use SpeedCalc, type DOS to 
go to the DOS menu. Select option 
L, which loads binary files from 
disk into memory. When DOS asks 
you for a filename, type SPCALC 
.OBJ. SpeedCalc will load and run. If 
you copy this file to another disk 
(one the contains DOS.SYS and 
DUP.SYS) and rename it AUTO- 
RUN .SYS, SpeedCalc will load and 
run automatically the next time you 
boot with that disk. 

Note: The AUTORUN.SYS file 
on your DOS master disk is respon- 
sible for booting up the 850 Inter- 
face Module for RS-232 commu- 
nications. There is no easy way to 
combine the 850 boot program with 
SpeedCalc, so you can’t access the R: 





30 COMPUTEI’s Best of Atari 





SpeedCale 


Kevin Martin and Charles Brannon 


device while using this program. If 
you need to send a SpeedCalc file to 
a serial printer or modem, print it to 
disk as explained below, then print 
or transmit the file data as you 
would any ATASCII text. 


The Atari 

SpeedCalc Screen 
SpeedCalc uses the top line of the 
screen as the command line. This is 
where SpeedCalc displays messages 
and asks you questions. 

Screen lines 2-4 are the input 
buffer area, This is the work area 
where you enter and edit data. As 
you'll see in a moment, the input 
buffer also displays the data con- 
tained in the current cell. The work 
area cursor is a left arrow symbol 
(+). After you begin to enter data, 
most SpeedCalc commands (except 
for the cursor movement keys) are 
deactivated until you press RE- 
TURN to enter the data into the 
worksheet. 

The lower 19 screen lines are 
your window into the spreadsheet. 
Though the spreadsheet contains 
many rows and columns, only a 
few can fit on the screen at one 
time. By scrolling the screen back 
and forth with the cursor, you can 
move the display window to any 
part of the spreadsheet. 

The SpeedCalc worksheet con- 
sists of 50 vertical columns labeled 
with letters (AA, AB ... BX) and 100 
horizontal rows numbered from 
1-100. The rectangle where a row 
and column intersect is called a cell. 
Cells are where you store data. 
With 50 columns and 100 rows, the 
SpeedCalc spreadsheet has a maxi- 
mum of 5,000 (50*100) cells. Due to 
memory limitations, however, only 
about a third of these can actually 
contain data. But you may spread 














out the data over all 5,000 cells if 
necessary, depending on the format 
you need. 


Moving The Cursor 

Each cell is identified with the let- 
ters of its column and the number 
of its row. For example, the cell at 
the extreme upper-left corner of the 
sheet is called AA1, since it’s in 
column AA and row 1. The cell 
below that is AA2. Moving one cell 
to the right from AA2 puts you in 
cell AB2, and so on. 

Your current position in the 
spreadsheet is shown by the high- 
lighted cursor. The simplest way to 
move around the sheet is with the 
cursor keys, which work just as 
they do when you're writing or 
editing a BASIC program. Press 
CTRL and the right cursor key to 
move right, and so on. Another 
way to move the cursor is with 
CTRL-H. Press CTRL-H once to 
“home” the cursor on the current 
screen: The cursor moves to the 
upper-left cell. Press CTRL-H twice 
in succession to move the cursor to 
cell AA1, the home position for the 
entire sheet. 

SpeedCalc also has a goto com- 
mand for moving the cursor over 
long distances. When you press 





CTRL-G, the command line dis- 
plays GOTO: followed by a cursor. 
The cursor genérally indicates that 
SpeedCalc is waiting for data—in 
this case it expects the name of the 
cell where you wish to go. If you 
enter BA88 at this point, SpeedCalc 
moves the cursor to the cell at col- 
umn BA in row 88, adjusting the 
screen window as needed. Take a 
few moments to practice moving 
around the spreadsheet with all 
three methods; you'll be using 
them a lot. In a later section, we'll 
discuss how to change the size and 
format of a cell. 


Keyboard Commands 
SpeedCalc offers many different 
commands, a few of which are en- 
tered by pressing one key. Howev- 
er, most commands are entered by 
pressing CTRL along with another 
key. CTRL-G, as you've seen, is the 
goto command, CTRL-A displays 
the amount of free memory avail- 
able, and so on. 

The most drastic command is 
CTRL-X, which exits SpeedCalc and 
returns to DOS. Since this effective- 
ly erases all data in memory, Speed- 
Calc prompts you with ARE YOU 
SURE Y/N? before it shuts down. 
To cancel the command, simply 





type N (or any key other than Y). If 
your Atari DOS 2.0/2.5 disk con- 
tains the file MEM.SAV (created 
with the CREATE MEM.SAV op- 
tion on the DOS menu), you can 
exit to DOS and then return to 
SpeedCalc—however, all spread- 
sheet data will be lost. To restart 
SpeedCalc from the DOS menu after 
exiting, select menu option M (Run 
At Address), then enter the address 
2000. If you’re using OS/A+ or 
DOS XL, use RUN 2000 instead. 

If you press SYSTEM RESET in 
SpeedCalc, you'll see the message 
SYSTEM RESET TRAPPED. No 
spreadsheet data is lost. If you’re 
using OS/A+ or DOS XL, type 
RUN 2000 to return to SpeedCalc. 

A few commands require you 
to press three keys at once. This 
sounds more awkward than it is in 
practice, since two of the three keys 
are OPTION and CTRL. For in- 
stance, the relative copy command 
is performed by pressing OPTION- 
CTRL-C (hold down the OPTION 
console key and CTRL, then press 
C). The table lists all the SpeedCalc 
commands, and the figure shows 
the keyboard layout with a descrip- 
tion of what each key does. We'll be 
discussing each command in more 
detail below. 





with most commands 
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| three Data Types 

Before entering any data, you must 
know what kind of data SpeedCalc 
accepts, There are three different 
types: numbers, text, and formulas. 
Let’s look at each type in turn. 


1. Numeric data consists of num- 
bers—the basic stuff that spread- 
sheets work with. SpeedCalc has a 
few simple rules for numeric data: 
A number must be a decimal value 
(base 10, not hexadecimal) com- 
posed of one or more digits from 
0-9, with an optional plus or minus 
sign. A decimal point is also option- 
al. If you include any other charac- 
ters in numeric input, SpeedCalc 
treats the entire input as text data 
(as explained below). Thus, the 
numbers 123, .001, and —65535 
are valid numeric data. The number 
65,535 is invalid because it includes 
a comma. 

The allowable range for num- 
bers in Atari SpeedCalc is similar to 
the range for Atari BASIC, roughly 
—1.7E+97 to 1.7E+98. If a calcu- 
lation produces a number outside 
the allowable range, you'll see the 
message *ERROR* in the cell con- 
taining the formula. This doesn’t 
happen very often, since SpeedCalc 
won't let you enter a number more 
than 36 digits long, and there’s 
rarely a need to use such large 
numbers unless you're tracking the 
national debt. 

Although an input value can 
be up to 36 digits long, numbers in 
SpeedCalc calculations are accurate 
only to nine digits. This must be 
taken into account when doing any 
calculation involving large values. 
For example, you can enter the val- 
ue 1122334455.66 into a cell, and 
the cell holds the value with no 
rounding. However, if you use the 
value from that cell in a formula, 
the value is rounded to nine dig- 
its—112233446.00—and the result 
of the calculation is accurate only 
for the first nine digits. 

You can enter values in scien- 
tific notation by following a num- 
ber with the letter E and the 
appropriate power of 10. For ex- 
ample, you can enter 1,234,000 as 
1.234E+06. However, scientific 
notation should generally be avoid- 
ed, since values outside the Atari’s 
maximum range may crash the pro- 

gram (if this happens, press RESET 
[eee 











and rerun the program from DOS 
as explained above). Since there’s 
only room for about 36 digits, un- 
predictable results may occur if you 
enter any number in scientific nota- 
tion with an exponent greater than 
35 (E+35). 

To see how entering numeric 
data works, let’s enter the number 
123 in cell AA1. No special com- 
mands are required to enter data: 
Just move the cursor to AA1 and 
begin typing. The left-arrow sym- 
bol shows the end of the data. 
While you’re entering the number, 
it appears only in the input buffer 
near the top of the screen (the in- 
verse-arrow cursor shows your cur- 
sor position). As soon as you press 
RETURN, the number appears in 
cell AA1 and the letter N appears at 
the upper right of the screen. The N 
signifies numeric, meaning that 
SpeedCalc has accepted the entry as 
valid numeric data. Move the cur- 
sor to a vacant cell, then move it 
back to AA1. The input buffer dis- 
plays whatever data is found in the 
cell under the cursor. When the cur- 
rent cell is empty, the buffer is emp- 
ty as well. 

If you want to change anything 
during data entry, press the BACK- 
SPACE key (BACKS on some Atari 
machines). BACKSPACE always 
deletes the character before the cur- 
sor (or has no effect if the cell is 
empty). Later on, we'll explain how 
to edit existing data. 

As you've seen, pressing RE- 
TURN enters a data item into the 
current cell. You can also end the 
input by pressing CTRL and a cur- 
sor key. The data is entered as if 
you had pressed RETURN, and the 
cursor moves in the indicated direc- 
tion. This feature is handy for en- 
tering a lot of data: Simply type the 
entry, move the cursor to the next 
cell, enter more data, and so on. 


2. Text data is not “data” in the 
strict sense, since SpeedCalc doesn’t 
use it in calculations as it does num- 
bers and formulas. Text data is 
there only to help people under- 
stand what the other data means. 
Text may consist of comments, ti- 
tles, column headings, subhead- 
ings, or whatever you need to 
interpret the numbers and formu- 
las. As an example, move the cursor 
to cell AA2 (just under AA1) and 





type the following line: 


THIS IS A PIECE OF TEXT DATA. 


You can use the BACKSPACE 

key to erase mistakes while you're 
typing. When you press RETURN, 
SpeedCalc displays T (for text) in the 
upper-right corner. In this example, 
the cell isn’t large enough to accept 
all the text, so only the leftmost 
portion appears in AA2. But even 
though you can’t see it, all of the 
text is there. Move the cursor to 
another cell, then move it back to 
AA2. As soon as you return to AA2, 
SpeedCalc displays all the text in the 
input buffer area. 
3, Formula data is a mathematical 
expression or formula. It may be as 
simple as 2 + 2 or as complex as 
your imagination (and mathemati- 
cal prowess) allows. The first char- 
acter in a formula must always be 
an equal sign (=). If you omit this 
symbol, SpeedCalc either signals an 
error or treats the data as text. 

The true power of a spread- 
sheet is that a formula in one cell 
can refer to another cell. This is 
easier to demonstrate than to ex- 
plain. Move the cursor to cell AA3 
and type the following line: 
=AA1*25.01+ @SQR(4) 


As soon as you press RETURN, 
SpeedCalc displays F (for formula) 
in the upper-right corner of the 
screen and puts the result of the 
formula (not the formula itself) in 
AA3. If AA1 contains 123, the val- 
ue 3078.23 appears in AA3. In plain 
English, this formula means ‘‘mul- 
tiply the contents of cell AA1 by 
25.01 and add the square root of 4.” 

Before we examine the formula 
more closely, here’s a quick demon- 
stration of what makes a spread- 
sheet such a powerful tool. Move 
the cursor back to AA1 and press 
CTRL-R. The command line dis- 
plays the message RECALCULA- 
TION IS ON, meaning SpeedCalc 
now automatically recalculates the 
entire sheet whenever you make a 
change. Now change the number in 
AA1 to 456 (simply move to the cell 
and start typing). The new result 
(11406.56) automatically appears in 
cell AA3. We'll explain more about 
automatic recalculation later. 

Note that the referenced cell 
must contain data that SpeedCalc 
can evaluate: a number or another 
formula. If the formula refers to an 











32 COMPUTEI’s Best of Atari 






| 
hen you want to talk Atari, 
| you want to talk to us. 





The 1040ST from Atari 





Call toll-free 1-800-233-8950 











anes TTA 


ST HARDWARE 


THE ATARI 1040 
MONOCHROME SYSTEM 


The Atari 1040 Monochrome System includes 
the Atari 1040ST computer with 1 megabyte of 
RAM, a built-in 32‘ disk drive, 192K ROM with 
TOS, Basic, power supply and monochrome 
monitor. 


$679 


No. AA51040M 





ATARI 520ST-FM 
MONOCHROME SYSTEM 


The Atari 520ST Monochrome System includes the Atari 
520ST-FM computer with modulator, disk drive, mouse, 
Basic and monochrome monitor. 

$509 


No. AA520STM 


SM 124 
HIGH RES 
MONOCHROME 
MONITOR 





A state-of-theart high resolution monochrome display for 
your 1040ST or 520ST system. For word and data 
processing, there’s no clearer, sharper display. 


$159 


No. AA5124 











ATARI 520ST- FM 
COLOR SYSTEM 


The Atari 520ST-FM Color System includes the Atari 
520ST-FM computer with modulator, disk drive, mouse, 
Basic and RGB color monitor. 

$659 


No. AA520STC 


Sc 1224 
RGB COLOR 
MONITOR 


A high performance RGB color monitor. The SC 1224 
faultlessly displays all 512 of the 1040ST’s colors. No 
doubt its startling display of bit-mapped color graphics 


will knock your socks off. 
$289 


No. AA51424 


Call toll-free: 1-800-233-8950 


Outside the U.S.A. 717-327-9575 Telex 5106017898 Fax No. 717-327-1217 
Most major credit cards accepted. 





JCATARI = SH204 





TARI HARD DRIVE 
ATARI MICRO DISK DRIVE ATARI SF314 DISK DRIVE ATAR L HAR 
© Single Sided * Double Sided * 20 Megabyte 


No AAS $129 women $209) wo. aasiee0 $569 


GTS-100 





INDUS GTS 100 SUPRA HARD DRIVE SUPRA HARD DRIVE 
g Re eel uy * 20 Megabyte * 30 Megabyte 


No.ast $219 n0.sso20st $549 no.ssos0st $769 





bee 
SONY DISKETTES 
MD1D SS/DD 5%" 
MD2D DS/DD 5%". 
MFD-1DD SS/DD 312” 
MFD-2DD DS/DD 312”... 











DISKETTE STORAGE 

Kalamar Teakwood (Holds 45 32”). 
Kalamar Teakwood (Holds 50 5%"). 
Allsop Holder (Holds 60 5%”)... 
Allsop Holder (Holds 30 342”) 


MAXELL DISKETTES 
MD1-M SS/DD 5%" 
MD2-DM DSI/DD 5% 
MF1-DDM SS/DD 31 
MF2-DDM DS/DD 312".... 




















( iy, ( Call toll-free: 1-800-233-8950 
ES hd Z Outside the U.S.A. 717-327-9575 Telex 5106017898 Fax No. 717-327-1217 
Most major credit cards accepted. 








Atari 65XE Computer 


More graphics modes, colors, Random Access Memory, text modes and independent 
sound voices than any other computer of its size. All in one stunning new body at a 
very low price. The Atari 65XE has 65,000 bytes of RAM. It uses the 6502C 

and is software compatible with the thousands of programs available 


for the 800XL 
ig $9999 


No. AA6SXE 


MONITORS (XL/XE) 














Atari 130XE Computer 


More graphics modes, colors, Random Access Memory, text modes, and independent 
sound voices than any other computer of its size. All in one stunning new body at a 
very low price. The Atari 130XE has 131,072 bytes of RAM. It uses the 6502C 
eros ars oe with the thousands of programs available 


No. AA130XE 





MAGNAVOX CM8502 
© 13” Composite Color 

* 330 x 350 Dot Resolution 
© 80 Column 


* 13” Composite Color 
© 80 Col. x 23 lines 
© Audio 


$1 79° No, CB1802 


No. NAP502 


INDUS GT 








Atari XF551 
SS/DD Floppy 
Drive 


Indus GT 
Full Atari XL/XE 
Compatible 


No. IADD $ 1 79° 


No. AA551 


COMMODORE 1802C 





ZENITH ZVM-Composite 
© 12” Composite 

¢ 25 x 80 lines 

e Anti-Glare Screen 

No. ZEG1230, Green 
No. ZEA1220, Amber 


$2Q900 $9499 


Supra 20 Meg 
Hard Disk Drive 
$669°° 


No. SJ0007 


*179°° 


Call toll-free: 1-800-233-8950 


Outside the U.S.A. 717-327-9575 Telex 5106017898 Fax No. 717-327-1217 
Most major credit cards accepted. 





ICD Rambo XL 


Turns your 800XI or 1200XL into a 256K system. 


No. ABO4 $2999 
ICD Multi I/O 256K 
No. ABOS 


5 function in one box. 
$169°° 
ICD US Doubler 


True double density and high speed for 


the 1050 drive. $3 299 


No. ABO9 


8.2 CONNECTION = 


ICD BBS Express! ST 
Written by Keith Ledbetter. 

Takes Bulletin Board systems into a new 
generation. Designed for Atari ST. 


No. AB10 $5999 


ICD Sparta DOS 
Construction Set 


No. ABO1 


$2999 


AATARL XOaH0L 


PERIPHERALS 


US Doubler 

(with SpartaD0S 
Construction Set) 

For Atari 1050 Disk Drive 


ICD R-Time 8 


We've got the time, if you've got the Atari. 


No. ABO8 $4999 
ICD Multi /0 1 Meg 


RAM Disk - P/S interface - spooler and more. 


All in one box. $28900 


No. ABO6 


ICD US Doubler 
w/Sparta DOS 


No. ABO2 


$4899 





ANCHOR VM520 


12 BPS for the Atari ST. 


$129 


No. AN520 


ATARI 
No. AAXM301 $4499 
No. AASX212 $8999 


SUPRA 2400 Baud 
$ 159° 
#159° 


No. SU2400AT (XL/XE) 
No. SJ2400ST (ST) 


CALL ON THE AVATEX MODEMS! 


Sule 


Call toll-free: 1-800-233-8950 


Outside the U.S.A. 717-327-9575 Telex 5106017898 Fax No. 717-327-1217 


Most major credit cards accepted. 











ATARI XM801/XM804 


¢ Dot Matrix _ 
gue «$189 
No. AAXM804 $ 1 79 


BROTHER M-1509 Dot Matrix 
* 180 CPS Draft/45 CPS NLQ 

© Auto Paper Loading 

¢ Friction and Pin Feed 

No. BRM1509 $389 





CITIZEN MSP10 
* 160 CPS Draft/40 CPS NLQ 
* 80 Column 

* Tractor Feed 

No. CZMSP10 


$259 


EPSON FX-86E 
© 240 cps Draft/40 cps NLQ 
© 9 Wire Dot Matrix 

© Selectype Control Panel 
No. EPFX86E 


CMO 


$349 





ATARI XDM 121 
© XL/XE Compatible 

° 12 CPS Daisywheel 
No. AAXDM121 


BROTHER HR-40 Daisywheel 


* 40 CPS, 136 Columns 

© 2 Color Printing 

© Friction and Forms Tractor 
No. BRHR40 


CITIZEN Premier 35 
© 35 cps Daisywheel 

© Built-in clock/calendar display 
© Error messages in English 
No. CZMSP35 


EPSON LQ-1000 

© 24 Wire Dot Matrix 

* 180 CPS Draft/60 CPS NLQ 
© 130 Column, Select Type III 
No. EPLQ1000 


$589 





$489 





$569 











BROTHER M1109 
* 100CPS/25 CPS NLQ 

© 80 Column/Dot Matrix 

° Tractor 

No. BRM1109 





BROTHER 2024L 24 Wire 
* 160 CPS Draft/96 CPS NLQ 
* 136 Column/272 Condensed 

© Tractor and Friction Feed 

No. BRL2024 $599 





EPSON LX-86 

* 120 CPS Draft/i6 CPS NLQ 
© 80 Column Dot Matrix 

* Includes cut sheet feeder 
No. EPL1 


$189 





EPSON EX-1000 
© 9 Pin Dot Matrix 

© 300 CPS Draft/50 CPS NLQ 
© 132 Column, 8K Buffer 

No. EPEX1000 


$499 


Call toll-free: 1-800-233-8950 


Outside the U.S.A. 717-327-9575 Telex 5106017898 Fax No. 717-327-1217 


Most major credit cards accepted. 





PRINTERS 











OKIMATE 20, OKIDATA ML-193 Plus PANASONIC 1080 


© Color Printing 144 X 144 DPI * 200 CPS Draft, 40 CPS NLQ e 100 CPS Draft/20 CPS NLQ 

¢ 80 CPS Draft ° 8K Print Buffer . 80 folumn : $ 

e Interface Optional * 9 Wire, 132 Column ° Tractor Fee 

No. OK20 $ 1 29 No. OK1931 $479 No. PA1080 1 69 





\] 
PANASONIC KX-P1595 STAR MICRONICS NX-15 TOSHIBA P321SL 
* 240 CPS Draft/21 CPS NLQ * 120 CPS Draft, /50 CPS NLQ © 24 Wire Print Head 
* 16% "' Paper Width ¢ 5K Buffer, 132 Column © 216/180/72 cps 
© Rear Push Tractor Feed © Friction & Tractor Feed ° Character font cartridges 
No. PA1595 $449 No. SGNX15 $3 19 No. TB321SL $529 









eae 










CRT VALET PRINTER INTERFACES FOR ATARI COMPUTERS 
e aes room fort your pantes Atari 850 Interface... ...$109°° — Supra Microprint.. 

pg ona MOU OBAL GY ECV! ICD P:R Connection $5999 Supra 1150...... 
RAC eee $QQ29 ico Printer Connection 36°? Supra 1151 (1200 XL).. 





Xetec Graphix Interface.. 3449 








i nee 


CURTIS RUBY 








CURTIS UNIVERSAL 


PRINTER STAND SURGE PROTECTOR SURGE PROTECTOR 

* Convenient Paper Feed * 6 Outlets ° 6 Outlets 

° Eos 80 Column Printers * Duplex Plug-in * 6 Foot Cord 

No GUUPSI $1499 A. cuser $2999 jeiGisere $5999 


= Ce am 
(oe ua ( ) Call toll-free: 1-800-233-8950 


\ Outside the U.S.A. 717-327-9575 Telex 5106017898 Fax No. 717-327-1217 
COMPUTER MAIL ORDER Most major credit cards accepted. 


ST SOFTWARE 


MICROPROSE 
SILENT SERVICE 


ACTIVISION HACKER II 
DOOMSDAY 


NO ADACO2 3 499 









ji AVAIAR 





ATARI 
FIRST WORD 


NO. ADATO3 1 499 
j ora Fa 


ACTIVISION 
MUSIC STUDIO 


‘NO. ADACO1 3599 






ATARI VOLUME IGR 5 
ALGEBRA I 


NO. ADATO6 1 799 


ELECTRONIC ARTS 
AUOTDUEL 


NO. ADEAO3: 3599 





INFOCOM ELECTRONIC ARTS 
HITCHHIKER FOOTBALL 
NO. ADINO1 28°29 NO. ADEA04 3599 








(a4 le) 


COMPUTER MAIL ORDER 





INFOCOM 
TRILOGY 





OSS PRECISION SOFTWARE 


PERSONAL PASCAL 


‘NO. ADAOSO1 4799 


aaa 


ACCOLADE 
HARDBALL 


NO. ADALO1 2599 





BATTERIES INCLUDED 


DEGAS ELITE 


NO. ADBIO3 48°92 


NO. ADMPO1 2599 NO. ADIN17 4499 





FIREBIRD 
THIEVES GUILD 


NO. ADFRO1 2 799 







MICHTRON 
MAJOR MOTION 


NO. ADMIO1 25°99 





PARADOX 
WAR ZONE 


NO. ADPAO2 26°29 


aan 


ACCESS 
LEADERBOARD 


NO. ADASO1 2599 


Most major credit cards accepted. 











DAC EASY 
ACCOUNTING 


NO. ADDAO1 3892 


HABA 
HABAWRITER 


NO. ADHAO2 2999 








PSYGNOSIS 
BARBARIAN 


‘NO. ADPSO3 2622 


Call toll-free: 1-800-233-8950 


Outside the U.S.A. 717-327-9575 Telex 5106017898 Fax No. 717-327-1217 


SOFTWARE 














SIERRA UNISON WORLD SUBLOGIC. TIMEWORKS VIP 
WINNIE THE POOH PRINTMASTER + FLIGHTSIMULATOR DATAMANAGER PROFESSIONAL 


NO. ADSOO1 1 799 NO. ADUWO1 2599 NO. ADSU01 a NO. ADTW03 = NO. ADVPO1 1 4499 


Laer 


> Print Shop 


ray 
rz 





TIMEWORKS SIERRA z MICROPROSE XL/XE BRODERBUND XUXE 
WORDWRITERST LEISURE LARRY TOP GUNNER PRINTSHOP 


NO. ADTWO1 4899 NO. ADSO02 26°2 NO. ADSSO2 2499 NO. AFMPO1 1 799 NO. BBA100D 2599 








ACCESS : XUXE ORIGINSYSTEMS XL/XE DATASOFT XL/XE SUBLOGIC xUKE MICROPROSE XU/XE 
LEADERBOARD ULTIMA IV ALT. REALITY FLIGHT SIMULATORI| §=©6F-15 STRIKE 


99 99 99 99 99 
NO. AFASO1 NO. AFORO1 36 NO. AFDSO1 2 1 NO. SUA1 33 NO. AFMP02 25 





SUBLOGIC 


CYGNUS XUXE ATARI "XUXE BRODERBUND XUXE ssi XLUXE 
STARFLEET | ATARIWRITER + KARATEKA GEMSTONE WARRIOR CALIFORNIA SCENERY 


NO. AFCY401 3499 NO. AA8036P 3599 NO. BBA138 1 799 NO. AFSSO01 i 299 NO. SUA2 1 499 


XUXE 





Outside the U.S.A. 717-327-9575 Telex 5106017898 Fax No. 717-327-1217 
Most major credit cards accepted. 


(of [e) Call toll-free: 1-800-233-8950 


CLOSEOUT SPECIALS 


YOUR FULL SERVICE ATARI HOUSE 


< Nigeliacs 


al 


DEFENDER’ 
AN 











GALAMAN “GiiRece SPACE ac. MSN 
ae ae srg N 


VIDEO EASEL = CENTIPEDE 
R 
covet STEF COMPUTER 


i 


a — ss Cusez0 | ener 


LOOSE UNBOXED ATARI ROM XL/XE CARTS 


Super Breakout Asteroids Qix 

Space Incaders Pac Man Exile 

Star Raiders Galaxian Robotron 
Missile Command Defender Eastern Front 


AVALON HILL ROCKLYN 
AT Deluxe Legionaire 
Gorf Vorrak 
Wizzard Of Wor Gypsy 
Anti Sub TGIF 
Journey To Planet Divex 
Arcade/Ghost Hunter 


Outside the U.S.A. 717-327-9575 Telex 5106017898 Fax No. 717-327-1217 


(4 [e) Call toll-free: 1-800-233-8950 


Most major credit cards accepted. 


WITH A FULL HOUSE OF PRODUCTS 
= “ - im 











CMO EXCLUSIVES 
SUNCOM Hacker Axlon 
Atari Special 32k RAM 


= (2 non-working 
Joystick 410 Recorders) (XL/XE) 


2 for $599 No. AAB410P $999 $ 1999 
FACTORY SEALED PROGRAMS 











AA4007 Music Composer 699 AA4125 Italian (Cass) 622) 
AA4010 Tic Tac Toe 699 AA4126 Speed Reading 399 
AA4011 Star Raiders 699 AA4127 Juggles Rainbow 198 
AA4012 Missile Command 699 AA415__ File Manager 1199 
AA4013 Asteroids 699 AA418 Home Manager 1499 
AA4022 Pac Man 699 AA5047_ Timewise (Disk) 499 
AA4025 Defender 699 AA5050 Mickey In The Great Outdoors 599 
AA4027 Qix 699 AAS018 Music Painter (Disk) 1499 
AA4102 Kingdom (Cass) 199 AA6006 Counseling Procedure 199 
AA4108 Hangman (Cass) 99 AA7012 Arcade Champ (No Joystick) 799 
AA4112 States & Capitals (Cass) 199 AA8030 E. T. Phone Home 699 
AA4123 Scram (Cass) 199 





Outside the U.S.A. 717-327-9575 Telex 5106017898 Fax No. 717-327-1217 
MAIL ORDER Most major credit cards accepted. 


C wi [e) Call toll-free: 1-800-233-8950 






STAR MICRONICS ATARI MAGNAVOX 


NX-10 Printer 1020 Printer/Plotter AV7300 82 Channel 

e 120 cps draft/30 cps NLQ © For Atari XL/XE TV Tuner 

° 5K Buffer, 80 column $ 99 

¢ Friction and tractor feed No. AA1020 3 1 No. NAP7300 $5999 
No. SGNX10 $ 159° 





ei J 


DATASHIELD : ATARI aoe HABA 


Surge Protectors 835 Modem HabaWriter 
$6929 e 300 BPS ¢ For Atari ST computers 
5100, No. DZS02 ¢ Power Supply/Phone Jack $2999 
* No Soft No. ADHAO2 
585, No. DZSO3 $5999 No. (AABS35 $ 1999 s 





When you want to talk Atari, you want to talk to us. 


Call toll-free: 1-800-233-8950 


Outside the USA 717-327-9575 Telex 5106017898 Fax No. 717-327-1217 


3 477 East Third Street, Department A213 
Williamsport, PA 17701 
All major credit cards accepted 


Computer Mail Order policies and particulars. 


Next day shipping on all in-stock items. ¢ Free technical support from our own factory-trained staff. ¢ Toll-free 
order inquiry. e No surcharge on VISA or MasterCard orders. ° Credit cards will not be charged until the order is 
shipped. © No limit and no deposit on COD orders. © No sales tax on orders shipped outside PA. * No waiting 
period for cashier's checks. SHIPPING. Add 3% (minimum $7.00) shipping and handling on all orders. © Larger 
shipments may require additional charges. ° Returned items may be subject to a restocking fee. © All items 
subject to availability and price changes. Educational Institutions call toll-free 1-800-221-4283. 











empty cell, or one that contains 
text, SpeedCalc signals the error by 
printing *ERROR* in the cell con- 
taining the incorrect formula. 


Mathematical Operators 
These symbols can be used as oper- 
ators in a formula: 

Operator 
+ addition 
= subtraction 

* multiplication 
if. division 

: exponentiation 
= equality 


Function 


One factor that affects formu- 
las is precedence, or the order in 
which mathematical operations are 
performed. In SpeedCalc, formula 
operators have the same prece- 
dence as in ordinary math. 

The first operators to be evalu- 
ated—those with the highest prece- 
dence—are those enclosed in 
parentheses. Where one set of pa- 
rentheses encloses another, the ex- 
pression in the innermost set is 
evaluated first. The next operators 
to be evaluated are exponents. Mul- 
tiplication and division have equal 
precedence; both operations are 
lower than exponentiation. Addi- 
tion and subtraction have the low- 
est precedence of all. To take one 
example, SpeedCalc evaluates the 
formula =5*(8+3*—2)°2—10/+2 
as the value 15, just as in ordinary 
math. Note how the result is affect- 
ed by the plus and minus signs 
before the two 2’s. 


Functions 
Formulas may also include any of 
the functions listed here: 


@ABS() absolute value 

@AVE() average of a block of cells 
@EXP() _ natural exponent 
@INT() _ integer 

@LOG() natural logarithm 
@RND() round to nearest integer 
@SGN() _ sign 

@SQR() square root 

@SUM() sum of a block of cells 

PI value of pi (3.14159265) 


All the functions except PI be- 
gin with the @ symbol and are 
followed by parentheses. The pa- 
rentheses of a function may contain 
a number or a formula. For ex- 
ample, the formula =@SQR(4) 
generates the square root of 4. The 
formula =@SQR(AA\1) returns the 
square root of whatever value cell 











AA1 contains. The function 
@INT( ) generates an integer 
(whole number) by truncating (dis- 
carding the fractional part of) a nu- 
meric value; note that this is 
different from rounding (for in- 
stance, the result of @INT(—4.3) is 
—4, not —5). Use the rounding 
function @RND() to round a value 
up to the nearest whole number. 
The function @AVE( ) calcu- 
lates the mean average of the val- 
ues in a block (group) of cells. The 
function @SUM( ) calculates the 
sum of a block. Both functions re- 
quire you to define the block so 
SpeedCalc knows which cells to in- 
clude in the calculation. This is 
done by putting two cell names 
separated by a colon in the paren- 
theses. The first cell name defines 
the upper-left corner of the block, 
and the second defines the bottom- 
right corner. To define a block in a 
single column, specify the top and 
bottom cells in the column. For in- 
stance, @AVE(AA1:AD20) calcu- 
lates the average of all the cells 
from AA1 to AD20. The function 
@SUM (AA1:AD20) calculates the 
sum of AA1 through AD20, and so 
on. An error results if any cell in the 
block is blank or contains text data. 


Editing The Sheet 

Editing is a very important spread- 
sheet function. The simplest way to 
change what a cell contains is to 
move to it and start typing. The old 
data in that cell is replaced by what- 
ever you enter. For instance, to re- 
place the contents of cell AA1 with 
the number 456, move to that cell, 
type 456, and press RETURN or 
exit with a cursor key. Press CTRL- 
K (think of kill) to erase what's in 
the current cell. To erase everything 
in the sheet, press SHIFT-CLEAR, 
Before carrying out this drastic op- 
eration, SpeedCalc asks you to con- 
firm it by pressing Y or N. 

In some cases, only a minor 
change is needed. Edit mode lets 
you change the data in a cell with- 
out retyping the entire entry. To 
activate edit mode, move to the de- 
sired cell and press CTRL-E. In this 
mode, up and down cursor move- 
ment is disabled, and the left/right 
cursor keys move within the input 
buffer. Typing in edit mode inserts 
new characters in the line: Every- 
thing to the right of the new charac- 





ter moves right one space (unless 
the buffer is already full). Because 
all keys insert automatically, the 
CTRL-INSERT key combination is 
disabled: Press the space bar to in- 
sert a blank space. Erase unwanted 
characters with the BACKSPACE 
key or CTRL-DELETE. The CTRL- 
DELETE combination does not 
move the cursor: It simply pulls the 
text to the right of the cursor toward 
the cursor position. Since the cursor 
keys have a different function in 
edit mode, you cannot use them to 
end the input. Press RETURN to 
enter the new data and escape from 
edit mode. 

SpeedCalc displays *ERROR* 
in a cell when you enter an errone- 
ous formula. Usually this means 
you've made a typing error in that 
cell, or the formula refers to text or 
an empty cell. A line of asterisks 
(**e***""*) sionals that a number is 
too large to be printed in the cell. 
Though these messages appear in 
the cell area, no data is lost. You 
may move to the affected cell, view 
its contents in the input buffer, and 
make whatever correction is needed. 


Recalculation 

Recalculation is the very core of a 
spreadsheet. As you know, entering 
or editing a piece of data makes 
SpeedCalc perform a calculation and 
put the result in the cell under the 
cursor. In most cases, the new data 
relates to data in other cells, so 
you'll ultimately want to recalcu- 
late the entire spreadsheet as well. 
This can be done manually or 
automatically. 


To recalculate the spreadsheet 
manually, enter CTRL-N. Speed- 
Calc begins at AA] and recalculates 
every cell that contains data, plac- 
ing fresh results wherever needed. 
If you switch to automatic recalcu- 
lation mode, SpeedCalc automati- 
cally recalculates the entire 
spreadsheet each time you enter 
new data or edit what exists. When 
you press CTRL-R, SpeedCalc 
changes the recalculation status 
and displays it at the top of the 
screen. If automatic recalculation 
was turned off before, it is now on 
(and vice versa). If you aren’t sure 
which mode you're in, press 
OPTION-CTRL-R; SpeedCalc dis- 
plays the mode without changing 
it. 
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Automatic recalculation can be 
fun to watch in a large spreadsheet: 
Every time you make a change, 
new results appear everywhere on 
the screen. However, the more data 
your spreadsheet contains, the 
longer it takes to update the entire 
sheet. For this reason, you may 
want to turn off automatic recalcu- 
lation most of the time, recalculat- 
ing manually whenever you need 
to view results. 

One problem with recalculation 
arises from the order in which cells 
are calculated, Because only one cell 
can be calculated at a time, you must 
sometimes recalculate the entire 
spreadsheet two or three times to 
get correct results in every cell (this 
is common to all spreadsheet pro- 
grams). For instance, say you have a 
formula in AA1 which refers to a 
formula in AB15. When SpeedCalc 
calculates AA1, it must use the exist- 
ing data from AB15—which is prob- 
ably out of date, since the formula in 
AB15 hasn’t been recalculated yet. 
To avoid this problem, you should 
always recalculate a sheet manually 
two or three times before printing it 
or saving it to disk. 


SpeedCalc offers a number of 
other features. Before experiment- 
ing with them, you should spend 
some time typing in a hypothetical 
spreadsheet—perhaps a fictitious 
yearly budget—to become thor- 
oughly familiar with the basic com- 
mands covered so far. Most 
importantly, create formulas using 
all the operators in different combi- 
nations. Try doing things that you 
know will cause errors. Then cor- 
rect the errors in edit mode, and so 
on. It takes a thorough grasp of the 
fundamentals to get the most out of 
SpeedCalc’s advanced features. 


Change Format 

The default (normal) format for nu- 
meric data is flush right with 
rounding to two decimal places. In 
other words, the number is dis- 
played in the rightmost part of the 
cell, with two numbers after the 
decimal point. Text and formulas 
are also displayed flush right. 
SpeedCalc offers several commands 
for changing cell formats. 


Change Format (CTRL-F). This 
command changes the location of 
data in the cell. When you press 








CTRL-F, the SpeedCalc command 
line displays the question FOR- 
MAT: LEFT, CENTER, OR RIGHT 
JUSTIFY?. Press L, C, or R to move 
the data to the left, center, or right 
of the cell. 

Change Decimal Places (CTRL-.). 
SpeedCalc also lets you change the 
number of decimal places for any 
cell. The default number of decimal 
places is 2, but you may change it to 
anything from 0-15. Press CTRL 
and the period key (CTRL-.) to 
change this value: SpeedCalc 
prompts you to enter a number 
from 0-15. If you choose zero deci- 
mal places, any number in that cell 
is rounded off to the nearest integer 
(whole number). If you choose 15, a 
number in that cell is not rounded 
off at all—SpeedCalc displays it ex- 
actly as you entered it or as it was 
calculated from a formula. 


Width (CTRL-W). The width com- 
mand changes the width of an en- 
tire column of cells. Move the 
cursor to any cell in the desired 
column, then press CTRL-W. When 
SpeedCalc displays the prompt 
WIDTH:;, respond with a number 
from 4-36. The entire screen is re- 
drawn to accommodate the new 
format, and may look very different 
depending on what value you 
chose. For instance, if you increase 
a column’s width, the rightmost 
column of the former display may 
disappear: SpeedCalc only displays 
as many complete columns as it can 
fit on the screen. If you decrease the 
width of a column, you may see 
asterisks where numbers used to be 
(indicating the cell is now too small 
to display the entire number). To 
get rid of the asterisks, expand the 
column as necessary. 

Global Format (OPTION-CTRL-F). 
This is the same as the ordinary 
format command, but operates 
globally, changing every cell in the 
sheet instead of just one. 

Global Width (OPTION-CTRL- 
W). This is a global version of the 
width command. Every column in 
the sheet changes to the designated 
width. 


Screen Color 

And Luminance 

SpeedCalc makes it easy to change 
the screen background and charac- 
ter colors to your liking. 
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Background Color (CTRL-B). 
Press CTRL-B to cycle forward 
through the available screen back- 
ground colors. 


Text Color (CTRL-T). This com- 
mand increases the luminance of 
characters on the screen, cycling 
forward through all of the available 
text colors. 

Previous Background Color (OP- 
TION-CTRL-B). The reverse of 
CTRL-B, this command cycles 
backward through the range of 
background colors. 


Previous Text Color (OPTION- 
CTRL-T). The reverse of CTRL-T, 
this command cycles backward 
through the range of text colors. 


Macro Editing 

After typing in a large spreadsheet, 
you may decide to make a major 
change. You may want to add new 
data somewhere in the middle, de- 
lete a section, or move a group of 
cells from one location to another. 
SpeedCalc’s macro (large-scale) 
editing commands simplify such 
operations, affecting an entire block 
of cells at once. A block is simply a 
group of cells connected in rectan- 
gular fashion. You can define it as a 
single cell, a row or column, or any 
rectangular area within the 
spreadsheet. 

There are two ways macro 
commands work: verbatim or rela- 
tive. To take a simple example, say 
that cell AA2 contains the formula 
=AA1*5 and you want to move its 
contents to cell AB2. When this is 
done in verbatim mode, AB2 con- 
tains an exact copy of what was in 
AA2 (=AA1*5). Note that the cell 
name used in the formula does not 
change: The formula still refers to 
AA1. If you perform the same oper- 
ation in relative mode, the cell 
name in the formula is adjusted to 
fit the new location. In this case, 
AB2 would contain the formula 
=AB1*5. 


Copy (CTRL-C). The copy com- 
mand copies a block of cells into a 
different location without disturb- 
ing the original cells. Place the cur- 
sor on the upper-left corner of the 
block you want to copy, then press 
CTRL-C. SpeedCalc prompts you to 
move the cursor to the lower-right 
corner of the block you want to 
copy. Once the cursor is in place, | 





press RETURN. Now SpeedCalc 
prompts you to move the cursor to 


the place where you want to put the 
block: This is the upper-left corner 
of the new position. Once the cur- 
sor is there, press RETURN again. 
The new data replaces whatever 
was contained in the designated 
cells. Note that if you define an 
impossible block (for instance, 
moving the cursor to the upper-left 
of the original position, rather than 
below and to the right), SpeedCalc 
does not copy any data. Press ESC 
if you change your mind and wish 
to cancel this command. 


Move (CTRL-M). This command 
works like a copy, but it fills the 
original cells with blanks. Though 
SpeedCalc has no express insert 
command, you can use this com- 
mand to make space for new data in 
the middle of a spreadsheet. Simply 
move everything below the inser- 
tion point down as far as you need. 
As with the copy command, you 
can press ESC to cancel this 
command. 


Relative Copy (OPTION-CTRL- 
C). This form of the copy command 
adjusts the cell names used in for- 
mulas within the copied block (see 
explanation above). When copying 
or moving data in relative mode, 
you may see some strange charac- 
ters displayed very briefly in the 
input buffer area of the screen: This 
harmless effect occurs because 
SpeedCalc uses that area for tempo- 
rary storage during these opera- 
tions, conserving memory for other 
purposes. 


Relative Move (OPTION-CTRL- 
M). This is the relative form of the 
move command, Cell names in for- 
mulas are adjusted to reflect the 
move. 


Memory Management 
SpeedCalc makes about 20K (rough- 
ly 20,000 characters) of memory 
available for data. As noted earlier, 
SpeedCalc lets you spread your data 
out over a much larger number of 
cells than you can actually fill with 
data. The extra space is provided to 
give you full control over the final 
format of the spreadsheet and to 
leave some elbow room for move 
and copy operations. 

Because memory is limited, 
you should keep careful track of 











SpeedCale Commands 


OPTION-CTRL-B 
OPTION-CTRL-C 
OPTION-CTRL-M 
OPTION-CTRL-R 
OPTION-CTRL-T 
OPTION-CTRL-W 


how much is free while using the 
program. Press CTRL-A to display 
the amount of free memory. We 
suggest limiting your spreadsheets 
to 1,600 cells (equivalent to 40 rows 
by 40 columns). If you've filled 
nearly all of free memory, you may 
have to break the spreadshaet into 
two smaller sheets. 

Although SpeedCalc checks the 
amount of available memory and 
displays an error message if you 
run out, you should be careful not 
to exhaust free memory. Any move 
or copy operation in process will be 
aborted if sufficient memory is not 
available. 


Disk Operations 

SpeedCalc has three disk commands 
for saving and loading data from 
disk and displaying the disk direc- 
tory. The disk directory command 
is the easiest to use: Simply press 
CTRL-D. To save a spreadsheet to 
disk, press CTRL-S. SpeedCalc 
prints SAVE: on the command line, 
followed by a cursor. Enter a valid 
Atari filename (including D:) and 
press RETURN. (If you change your 
mind and decide not to save any- 
thing, press RETURN without typ- 
ing a filename.) If no disk error 
occurs while the spreadsheet is be- 





Command Action 

CTRL-A available memory check 
CTRL-B next background color 
CTRL-C copy block verbatim 
CTRL-D disk directory 

CTRL-E edit current cell 
CTRL-F change cell format 
CTRL-G goto selected cell 
CTRL-H home cursor 

CTRL-K clear current cell 
CTRL-L load SpeedCalc file 
CTRL-M move block verbatim 
CTRL-N recalculate sheet now 
CTRL-P print cells from AA1 to cursor 
CTRL-R turn recalculation on/off 
CTRL-S save SpeedCalc file 
CTRL-T increase text luminance 
CTRL-W change column width 
CTRL-X exit SpeedCalc to DOS 
CTRL-. change decimal places 
SHIFT-CLR clear spreadsheet 


previous background color 
copy block relative 

move block relative 

check recalculation status 
decrease text luminance 
change width of all columns 


Stel os eA A 9 es 





ing saved, SpeedCalc displays NO 
ERRORS in the command line and 
returns you to command mode. If 
there was an error, you'll hear a 
beep and see the message I/O ER- 
ROR # followed by an error num- 
ber in the command line. Your DOS 
manual explains the meaning of the 
various DOS errors. 

To load a saved file from disk, 
press CTRL-L. Again, you can can- 
cel the operation by pressing RE- 
TURN without entering a filename. 
SpeedCalc prompts you to enter the 
filename and displays the error sta- 
tus when the operation is complete. 
If an error occurs while loading, 
SpeedCalc clears the partially loaded 
sheet to prevent a program crash. 


Printing 

SpeedCalc lets you print data to 
three different devices: to the 
screen for previewing output (E:), 
to a printer for permanent docu- 
mentation (P:), or to a disk file for 
integrating the data with a Speed- 
Script document (D:filename). 

To print a hardcopy of the 
spreadsheet to a printer, press 
CTRL-P and then enter P: when 
asked for (Device:Filename). Before 
using this command, you must posi- 
tion the cursor below and to the right 
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of the block of cells you wish to print. 
The upper-left corner of the printout 
starts at cell AA1. To preview the 
printed output on the screen, enter 
E: in response to the same prompt. 

You can also print SpeedCalc 
data to a disk file for use in a Speed- 
Script document. When SpeedCalc 
prints the prompt (Device:File- 
name), enter D:filename. The data is 
saved as a disk file of that name. 
Note that printing to disk creates a 
different type of file than saving to 
disk, and SpeedCalc cannot reload 
files in the print format. You should 
save files you wish to reload into 
SpeedCalc, and print files you wish 
to load into SpeedScript. 


SpeedsScript Integration 
SpeedCalc sends data to the printer 
in simple, plain vanilla form. That 
may be fine for personal use, but if 
you're creating a document for oth- 
ers to view, you may want special 
features such as boldface, underlin- 
ing, italics, and so on. Since Atari 
SpeedScript already offers a way to 
access these features (and many 
more), no attempt has been made to 
duplicate them in SpeedCalc. 

No special tricks are needed to 
load a SpeedCalc file into Speed- 
Script. After printing the file to disk 
as explained above, exit SpeedCalc, 
then load and run SpeedScript. Now 
load the file as you would any 
SpeedScript document. The data ap- 
pears on the screen, ready to be 
edited in any way you wish. Again, 
keep in mind that SpeedScript can 
load only those files which have 
been printed to disk, not saved. 


Cc 
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Atari 
FontMaker 


Charles 


“FontMaker” simplifies the design of 
character sets for all text modes on 
Atari 400/800, XL, and XE comput- 
ers. Although programmers will find 
FontMaker a valuable addition to 
their utility library, nonprogrammers 
can also benefit. Whether you want 
Old English or a computer age font, 
FontMaker has the tools you need to 
express your creativity. It requires at 
least 16K RAM; disk drive recom- 
mended. Disk File: FONT.OBJ, 
FONTLOAD.BAS, and CHSET. 


“FontMaker” is a sophisticated 
character editor written completely 
in machine language to work with 
all Atari text modes. Even though a 
character set (or font) editor is a 
handy utility for programmers, you 
don’t need to know anything about 
machine language or programming 
to have fun with it. We include a 
simple subroutine that lets you load 
and merge character sets with your 
own BASIC programs. 


Using FontMaker 

To use FontMaker, type DOS to go 
to the DOS menu. Select option L, 
which loads binary files from disk 
into memory. When DOS asks you 
for a filename, type FONT.OBJ. 
FontMaker will load and run. If you 
copy this file to another disk and 
rename it AUTORUN.SYS, Font- 


Maker will load and run automati- 
cally the next time you boot with 
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that disk. 
Editing Characters 


To get an idea how the program 
works, follow along with this article 
as you run the program for the first 
time. You'll see a screen with a 
colorful 8 X 8 grid, a list of brief 
instructions, and four rows of char- 
acters at the bottom of the screen. 

When FontMaker starts, it asks 
you to pick a character. You can edit 
one character at a time. When 
you're asked to select a character, 
you can use the joystick to move a 
cursor around in the four rows of 
characters, then press the fire but- 
ton to select the character high- 
lighted by the cursor. Or you can 
simply press the keyboard key cor- 
responding to the character. Action 
then shifts to the 8 X 8 character 
editing grid. 

Within the grid, you can move 
the editing cursor (a hollow white 
box) with either the joystick or the 
cursor keys. You don’t need to use 
CTRL with the cursor keys to move 
the cursor—CTRL-cursor up/ 
down/left/right and SHIFT-cursor 
up/down/left/right are reserved 
for other features. When drawing in 
the character grid, press the fire 
button or the space bar to reverse 
(toggle) the dot at the cursor posi- 
tion. Previously set dots are turned 
off, and blank spaces are turned on. 
You can hold down the fire button 
while you move the joystick to 
draw lines and figures. 








As you change the grid, you 
can see the character in actual size 
in the character set window. The 
cursor highlights (reverses) the se- 
lected character, but a row of the 
character you're editing is also dis- 
played. In addition, there’s a sam- 
ple of text (“The quick brown fox 
jumped over the lazy dogs”) so you 
can judge relative character height 
and spacing. 

To create an entirely new char- 
acter, you may want to start by 
pressing SHIFT-CLEAR to erase the 
existing character pattern. This gives 
you a clean canvas for your design. 


Undo Your Mistakes 

If you don’t like a change you've 
made, press U to undo all the 
changes made since you've selected 
the character. Press U again to undo 
the undo, restoring the change 
you've made. You can press F to fix 
a character, recopying its image 
from the standard character set 
stored in the computer’s Read Only 
Memory (ROM). It’s important to 
distinguish between these options: 
U reverts to the previous character 
image, F always gives you the ROM 
image. If you change the letter A to 
a spaceship, change B to a rocket, 
then go back to A and change the 
spaceship to an alien, U switches 
between the alien and the space- 
ship; F gives you the pattern for the 
letter A. Beware that you can’t undo 
the Fix command. 

If you hold down the OPTION 
button while pressing F, the entire 
character set is fixed, recopied from 
ROM. This wipes out any changes 
you have made to the character set, 
so be careful. 

To select another character to 
edit, press P and use the joystick or 
keyboard to pick the new character. 
In some text modes (see the G com- 
mand below), the joystick cursor 
may seem to move strangely. It 
consistently moves up or down be- 
tween rows of 32 characters. Since 
there are only 20 characters per line 
in modes 1 and 2, these rows wrap 
around the right margin. You move 
left and right within a row of char- 
acters, and up and down between 
rows of 32 characters. 

FontMaker can display the 
character set in all Atari text modes. 
These are GRAPHICS 0 (the de- 
|e text mode), ‘“GRAPHICS 012” 











(technically known as ANTIC 3, a 
nine-line true-descender mode), 
multicolor ANTIC mode 4, multi- 
color ANTIC mode 5, GRAPHICS 
1, and GRAPHICS 2. Press G to 
cycle through these modes. 


The SpeedScript 
Character Mode 

If you've never heard of the ANTIC 
text modes, don’t fret; they’re not 
normally accessible from BASIC. 
The Atari SpeedScript word proces- 
sor (and, incidentally, the PaperClip 
word processor from Batteries In- 
cluded) uses the ANTIC 3 mode for 
large, readable characters. ANTIC 
3, nicknamed GRAPHICS 0%, is a 
special 40-column mode that lets 
you define characters within an 8 X 
10 character space. Other Atari text 
modes have only an 8 X 8 charac- 
ter grid. This means that ANTIC 3 
characters can have true descend- 
ers. (A descender is the part of a 
character that drops below the line 
of type, such as the tail on a lower- 
case y or j.) 

You still use just eight rows to 
define a character in ANTIC 3, but 
the character is positioned within 
ten screen scan lines. For uppercase 
characters, the eight rows of the 
character grid are displayed in rows 
1-8 of the character matrix, with 
two blank lines at the bottom of 
each character, reserving space for 
lowercase descenders. For lower- 
case characters, the first two lines of 
the character grid are forced blank. 
The first two rows of the character 
definition are actually displayed at 
lines 9 and 10 of the character 
space, making it easy to reserve 
space for the descenders. The third 
through eighth rows of the charac- 
ter are displayed starting at the 
third line of the character space. 

This may sound confusing, but 
fortunately FontMaker lets you de- 
sign ANTIC 3 characters without 
having to mentally translate what 
you see on the grid to what the 
character should look like. (How- 
ever, the Rotate option seems to 
work strangely in this mode due to 
the unusual memory configuration 
used by ANTIC 3 characters.) Just 
be aware that lowercase characters 
are actually written two lines lower 
on the screen than uppercase char- 
acters. If you start with the normal 
character set, you'll need to use the 





roll and shift options to align the 
characters. Using the roll or shift 
commands (see below), roll the 
lowercase characters down two 
lines and all the uppercase charac- 
ters down by one line. While you 
work, refer to the “quick brown 
fox” sentence to see that all the 
characters line up properly. 


Since there are forced blank 
lines for uppercase characters, you 
can use the lower seven lines to 
define a large character. Leave the 
top line blank if you want two-line 
descenders. The normal Atari char- 
acter set only uses six columns for a 
character, giving two pixel spaces 
between each character on the 
screen. A larger character can use 
up to seven columns, leaving the 
last column blank to keep charac- 
ters from running into each other. 
When designing some character 
sets, though, such as a cursive 
script, you may want characters to 
connect together, so you can use 
the full horizontal space. 

You can press the CTRL-cursor 
keys to roll the character within the 
grid. Pixels that are pushed off the 
edge of the grid wrap around to the 
opposite side. This is especially 
useful for those ANTIC 3 charac- 
ters. If you press SHIFT with the 
cursor keys, the pixels that are shift- 
ed off the edge of the grid are lost. 
This can be used to crop a character, 
or quickly erase a certain column or 
row. Just roll the character until the 
column or row you want to erase is 
at the edge of the grid, then shift the 
character to push away the pixels. 

Other special commands: 
Press I to invert the character, re- 
versing all the pixels within the 
grid. R rotates the characters 90 de- 
grees (turns the pattern on its side). 
Press R twice to turn a character 
upside-down. M gives you a left-to- 
right mirror image of the character, 
as if you picked up the character, 
flipped it on its back, and put it 
back down. 

Press C to copy the character 
you're editing to a new position in 
the character set. The current char- 
acter replaces the character you se- 
lect with the joystick or keyboard. 
Be careful with this, since you can 
unintentionally erase a cherished 
character. After the copy, the char- 
acter you copied to is selected for 
editing. 
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Saving And Loading 


When you're ready to save your 
character set, just press S, then type 
in a legal Atari filename at the 
prompt: 

Save (Device:Filename> 

Include the D: for disk or C: for 
cassette. You can’t save to the E: 
(screen editor) or S: (screen) de- 
vices, so if you forget the drive 
specification and your filename be- 
gins with E or S, FontMaker cancels 
the save. If you selected the save 
command by mistake and want to 
cancel it, just press RETURN when 
asked for the filename. 

To load a character set into 
FontMaker, press L and enter the 
filename you used to save the char- 
acter set. This will replace the char- 
acter set in memory, so be sure to 
save the one you're working on if 
you want to keep it. Again, if you 
select this command by mistake, 
press RETURN at the prompt to 
cancel the load. 

FontMaker is compatible with 
character sets created with ‘‘Super- 
Font” (originally published in 
COMPUTE!, January 1982, and also 
found in the First Book of Atari 
Graphics). FontMaker sets are also 
compatible with many other Atari 
character editors. We found that a 
FontMaker set can be loaded into 
the popular Instedit editor if you 
use a filename extension of .SET. 
Character sets created with the Iri- 
dis Fontedit also work with 
FontMaker. 

If FontMaker can’t save or load 
a character set due to a bad file- 
name or problem with the disk, it 
displays the message I/O ERROR: 
PRESS RETURN. Press RETURN 
and try the save again, after you've 
figured out what went wrong. 

When you're done editing char- 
acters, press the ESC (escape) key to 
exit FontMaker to DOS. Be sure 
you've saved the character set you're 
working on if you want to keep it. 


Using Fonts With BASIC 

The Bytes option in FontMaker is 
primarily for programmers who 
want a list of the eight numbers that 
define a character, handy for 
changing just a single character in a 
program. But if you want to include 
an entire character set in your pro- 
gram, copying down these numbers 
can be tedious. Instead, you can use 








the two BASIC programs described 
below to add redefined character 
sets to BASIC. 

“Fontloader,’”” (FONTLOAD 
.BAS on the disk) is a subroutine 
you can merge with your BASIC 
program to load the character set 
into memory from disk. Just change 
the filename in line 1010 to the 
filename of your character set. The 
program loads the character set at 
the memory location CHSET, 
which is defined as eight pages 
back from the top of memory (loca- 
tion 106). Change this if you want 
to put your character set some- 
where else. If a GRAPHICS com- 
mand resets the character set, you 
can use POKE 756,CHSET/256 to 
re-point the character set vector to 
your RAM character set. Use POKE 
756,224 to display the ROM char- 
acter set, located at memory loca- 
tion 57344 ($E000). 

If you’re using a Translator 
type of program on XL and XE com- 
puters, you can change CHSET 
(line 1030) to 57344 to load the 
character set directly into the RAM 
space corresponding to the position 
of the ROM character set. This 
keeps the character set in memory 
until you turn off the machine. 

Use ‘Character Set Data- 
maker” (CHSET.BAS) if you’d rath- 
er store your character set as part of 
your program in DATA statements. 
The Datamaker actually creates an- 
other program that you can merge 
with your own program. It creates 
DATA statements for only those 
characters that have been changed 
from the ROM image. Datamaker 
asks for the filename of your char- 
acter set and a filename you'd like 
to use for the program it creates. 

After using Datamaker, type 
NEW and use ENTER to load the 
program created by Datamaker. As 
with Fontloader, you can change 
CHSET in the program created by 
Datamaker if you want to deter- 
mine yourself where the character 
set should go in memory. The pro- 
gram created by Datamaker copies 
the ROM set down to RAM (at 
CHSET), POKEs in the new charac- 
ters, and switches the character 
pointer at 756 to the new set. 
Again, you can use POKE 756, 
CHSET/256 to reenable the-set if 
your program somehow resets this 
pointer. 
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Atari BASIC Debugging Tool 


Here's a powerful debugging utility 
that lets Atari BASIC programmers 
analyze and manipulate variables, 
search for BASIC keywords, produce 
printed documentation of important 
program information, and call up disk 
directories without leaving BASIC. It 
requires at least 40K RAM, a disk 
drive, and Atari DOS 2.0 or 2.5. Disk 
Files: DEBUT.A, DEBUT.B. 


“DEBUT,” a utility for debugging 
Atari BASIC programs, was in- 
spired by the ‘Atari Wedge” (COM- 
PUTE!, December 1982). It uses the 
Wedge technique to provide BASIC 
with direct-mode commands for 
listing and locating variables, 
dumping variable values, and re- 
placing one variable with another. 
It also searches for BASIC 
keywords and includes a DIR com- 
mand for listing the disk directory. 
Output is easily redirected from the 
screen to the printer, disk drive, or 
any other output device. And be- 
cause DEBUT is written in machine 
language, it remains completely 
transparent—BASIC programs can 
be loaded, modified, tested, and 
saved without interference. 


Preparing DEBUT 

The program that accompanies this 
article creates DEBUT as an AUTO- 
RUN.SYS file. There are two ver- 
sions of the program. The first is 
intended for use with Revision A of 
Atari BASIC. If PRINT PEEK(43234) 





DEBUT 
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returns 162, then you have revision 
A. BASIC Revision A was the car- 
tridge shipped with the Atari 400/ 
800/1200XL. The other version is 
intended for use with Atari BASIC 
Revision B or C. Atari BASIC Revi- 
sion B was shipped in the 600XL 
and 800XL computers. Revision C 
is built in to the XE models. It is also 
available on cartridge for those who 
have earlier versions of BASIC. 

Since DEBUT creates an AUTO- 
RUN.SYS file when it is run, be 
sure to insert the disk you want to 
write the file onto before running 
the program. No matter what ver- 
sion of BASIC you use, load DE- 
BUT.B. Now, if you have revision A 
BASIC, type ENTER“D:DEBUT.A”. 
This will modify DEBUT so that it 
works with your computer. Now, 
put a disk in the drive and run the 
program. Make sure an AUTO- 
RUN.SYS file—such as Atari 
SpeedScript or SpeedCalc—doesn’t 
already exist on the disk. To start 
DEBUT, turn the computer off, 
make sure a disk with the DEBUT 
AUTORUNSYS file is in the drive, 
then turn the computer on. DEBUT 
loads automatically and announces 
its presence. This message appears 
whenever you press SYSTEM RE- 
SET, reminding you that DEBUT is 
active. 

DEBUT protects itself by reset- 
ting MEMLO (the pointer to the 
bottom of free memory, locations 
743 and 744) and by trapping the 
DOS command. As in the Atari 
Wedge, typing KILL gets rid of the 








utility and enables DOS. 

Note: DEBUT works with Atari 
DOS 2.0 and 2.5, but may not work 
with other types of DOS, especially 
after a SYSTEM RESET. 


Using DEBUT 

Once DEBUT is up and running, 
you have four new commands at 
your disposal for debugging and 
documenting BASIC programs— 
plus the DIR command. You type 
the command and press RETURN, 
just as you would with any direct- 
mode BASIC statement. Type DIR, 
for example, to list the disk directo- 
ry, or use the form DIR D:filespec to 
list specific files, The ? and * wild- 
card characters are allowed, and 
drive numbers (D2:, D3:, etc.) can 
be specified as well. (D: defaults to 
drive 1.) 

Now you're ready to load one 
of your BASIC programs and try 
the four main commands: 

FIND (Find a variable or BASIC 
keyword.) 

(Replace one variable with 
another.) 

(List variables and cross-reference 


line numbers.) 
VIEW (View the values of all variables.) 


REP 
XREF 


These commands act on your 
entire BASIC program unless you 
specify a range of line numbers 
using the form starting line,last line. 
You may specify either or both. 
When specifying only the last num- 
ber, precede it with a comma, or 
DEBUT thinks it’s a starting num- 
ber. The line range parameter is 
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optional, so it follows the other ar- 
guments to the command, as we'll 
explain below. 

All commands can also use the 
output switch—a slash appended to 
the command followed by the 
name of the device to which you 
want to redirect output (P for Print- 
er, D for Disk, C for Cassette, etc.). 
This sends the command’s output 
to the device rather than to the 
screen. To send the disk directory 
listing to the printer, for example, 
type DIR/P. This option uses chan- 
nel 1 for output, closing the channel 
when it’s done. Files created on 
disk or cassette are ASCII files 
which can be viewed with most 
Atari word processors or ENTERed 
into memory with BASIC. 

We'll see more examples as we 
take a detailed look at each 
command. 


The FIND Command 
With FIND, you can quickly identi- 
fy any lines in your program that 
contain a certain variable or BASIC 
keyword, Here is the general format: 
FIND [/output device] target [starting 
line, last line] 
where /output device is the optional 
switch for redirecting output from 
the screen; target is the variable 
name or BASIC keyword you want 
to find; and starting line,last line is 
the optional line number range for 
the search. 

FIND lists every line in which 
the target appears. The target can 
be a statement name (keywords 
that begin a statement, such as 
PRINT, PLOT, and POKE), a func- 
tion name (such as RND, COS, and 
PEEK), or a variable name, Include 
the right parenthesis as part of sub- 
scripted variable names, and the 
dollar sign as part of string variable 
names. (Remember: X, X(, and X$ 
are three distinct variables.) 

FIND does not locate keywords 
that are neither statements nor func- 
tions—THEN and TO, for instance. 
GOSUB and GOTO are missed 
when they appear as part of the ON- 
GOSUB or ON-GOTO statements. 
Also, FIND won't locate any opera- 
tors, such as OR, AND, +, and /, to 
name a few. 

FIND does locate ERROR lines, 
however; use FIND * for this 


ee 





Directing output to the disk 
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drive (FIND/D;filename) presents 
an interesting possibility—the file 
thus created can later be retrieved 
using BASIC’s ENTER command, 
allowing you to sift lines out of one 
program to create another. 

Perhaps you've discovered 
that keywords can sometimes be 
used as variable names in Atari 
BASIC. FIND assumes that if it’s 
spelled like a keyword, it is a key- 
word. You can force FIND to search 
for variables only by preceding the 
variable name with the greater- 
than symbol (>). Thus, FIND LEN 
comes up with all occurrences of 
the LEN function, while FIND >LEN 
lists occurrences of a variable called 
LEN. This option is needed only if 
your target variable could be con- 
fused with a keyword. (Be careful 
when choosing variable names in 
Atari BASIC. LET NOTE=66 cre- 
ates a legitimate variable, but if you 
try to access its value—for example, 
SOUND 0,NOTE,10,10—BASIC 
treats it as NOT E, while FIND, 
without the > option, would go off 
looking for the keyword NOTE.) 

When you specify a line num- 
ber range with the FIND command, 
only those lines within that range 
are listed. Here are some examples: 
FIND X( 


(List all lines in the program con- 
taining the array variable X.) 
FIND TEMP 100 


(List all lines containing the vari- 
able name TEMP, beginning at line 
100.) 


FIND/P CHR$,100 


(List all lines through line 100 con- 
taining the function CHR$ and 
send the listing to the printer.) 
FIND * 100,200 


(List all lines from 100 through 200 
that contain ERRORs.) 


FIND/D:NEWFILE.ASC PRINT,20000 


(Create a disk file named NEWFILE 
.ASC to hold the listing of all lines 
through line 20000 that contain the 
keyword PRINT.) 


The XREF Command 

As you write an Atari BASIC pro- 
gram, newly declared variables are 
added to an area of memory called 
the variable name table. XREF lists 
the contents of this table and cross- 
references the lines in which each 





variable appears. Here is the gener- 
al format: 

XREF [/output device] [starting line,last 

line] 

where /output device is the optional 
switch for redirecting output from 
the screen; and starting line,last line 
is the optional line range parameter. 


Often, XREF finds variables in 
the variable name table that don’t 
actually appear in your program. 
You can recognize these unused 
variables because XREF lists them 
with no line number references. 
Unused variables can happen when 
you delete all occurrences of a cer- 
tain variable from a program, or 
when you misspell a variable or 
command and BASIC thinks you're 
creating a new variable. These un- 
used variable names clutter up the 
variable name table, which might 
become a factor in a long program 
since the table is limited to 128 
names. 


XREF can help you eliminate 
this deadwood. If a large number of 
unused variables show up, you can 
clear them out by LISTing the pro- 
gram to disk, typing NEW, and 
then re-ENTERing the program. 
(LIST and ENTER reconstruct the 
variable name table, whereas SAVE 
and LOAD preserve it.) 

When you specify a line num- 
ber range with XREF (for instance, 
XREF 1000,2000), only those vari- 
ables and line references within 
that range are listed. At the foot of 
the listing, both the count of listed 
variables and the total number of 
variables in the name table are 
displayed. 

XREF/P creates a hardcopy of 
the variable listing—useful docu- 
mentation. XREF also makes it easy 
to spot misspelled variable names. 
No longer must you trace through a 
recalcitrant program line by line 
only to find that your mysterious 
bug is due to the slip of a finger. And 
if you're as poor a typist as I am, 
you'll be making frequent use of the 
REP command described below. 

Here are a few examples: 
XREF 


(List and cross-reference all vari- 
ables in the program.) 
XREF 2000,2999 


(List and cross-reference all vari- 
ables in the subroutine in lines 2000 














| COMPUTE! Books’ 


WAREHOUSE 
CLEARANCE 


SALE 


You can order any of the following groups of books 
for $9.95*. Or, choose any three books from any- 
where in this ad and pay $9.95* for all three. Each 
additional book after 3 is just $2.00. (If you want only 
one or two books, the cost is $4 each.) 








Check the books or groups of books you want and 
mail this coupon with your payment to: 


COMPUTE! Books 
Customer Service 
PO Box 5038 
F.D.R. Station 
New York, NY 10150 


* Add $2 per order for shipping and handling. 











O Group | $9.95 
O Creating Arcade Games on the TI-99/4A 2386272 
(11 COMPUTE!’s Guide to Extended BASIC Home 

Applications on the TI-99/4A 2386418 
O Basic Programs for Small Computers 2386388 
OC COMPUTE!’s Computing Together 2386515 
O Group Il $9.95 
O Home Applications in Basic for the IBM PC 

and PCjr 2386604 
O Investment Management with Your Personal 





Computer 005X 
O COMPUTE!'s IBM PC and PCjr Games for Kids 
2386493 


O Group Ill 

O Putting Junior to Work: A Guide to the IBM PCjr 
2386906 

O COMPUTE!'s Telecomputing on the IBM 2386965 

0 COMPUTE!'s Kids and the IBM PC and PCjr 
2386930 


O Group IV $9.95 


O Programmer's Reference Guide to the Color 











Computer 2386191 
O The Home Computer Wars 2386787 
0 COMPUTE!’s Personal Telecomputing 2386477 
O Home Energy Applications 2386108 


O The Greatest Games: The 93 Best Computer 
Games of All Times 2386957 
O Basic Programs for Small Computers 2386388 


O Group V $9.95 
D MacTalk: Telecomputing on the Macintosh 





238685X 
O MacOffice: Using the Macintosh for Everything 
0068 

















Name Using Your Macintosh: Beginning Microsoft BASIC 
and Applications 0211 
Address O Maclideas 0157 
City State Zip O Group VI $9.95 
O Easy Basic Programs for the Apple 2386884 
A vee GiiMasteteard 5A (The Apple Ile: Your First Computer 0017 
Cou IN Pee O COMPUTE!’s Guide to Telecomputing on the 
O U.S. money order Apple 2386981 
liCheck drawn :on'a\U-S: bank SpeedScript: The Word Processor for Apple 
Personal Computers 0009 
Subtotal O The Greatest Games: The 93 Best Computer 
Sales Tax (NC residents add 5%; NY Games of All Times 2386957 
residents add 8.25%) ie 
ae: ; O Group VII $9.95 
Sue ngrepa tending e200 $___2.00 FF COMPUTE!'s First Book of Atari 2386000 
1 COMPUTE!’s Second Book of Atari Graphics 
Total payment enclosed $ 2386280 
Offer good while quantities last. All sales final. 0 COMPUTE!'s Second Book of Atari 238606X 
Please allow 4-6 weeks for delivery. Oj Mapping the Atari 2386094 


COMPUTE! Publications, Inc. abd 


A Capital Cities/ABC, Inc. Company 


1 














through 2999.) 
XREF ,10000 


(List and cross-reference all vari- 
ables up to line 10000.) 


XREF/D:VARLIST 


(List and cross-reference all vari- 
ables in the program, and send the 
list to the disk file VARLIST.) 


The REP Command 

Now it’s easy to repiace those cryp- 
tic variable names with new names 
of crystal clarity—or, depending on 
your motives, vice versa. REP acts 
in a flash, replacing old variable 
names with new variable names. 
It’s handy for making corrections 
and tightening up code—but be 
careful. With or without such a 
command, the more ambitious your 
program, the wiser it is to save 
backup copies and document 
changes as you make them. 

Here is the general format: 


REP [/output device] oldvar newvar 
[starting line,last line] 


where /output device is the optional 
switch for redirecting output from 
the screen; oldvar is the old variable 
name; newvar is the new variable 
name (separated by a space, not a 
comma, from oldvar); and starting 
line,last line is the optional line 
number range. (The only output 
produced by the output switch is a 
message telling you how many 
variables were changed.) 

REP does not let you replace 
keywords or mismatched variable 
types (for instance, you can’t 
change A$ to A). Also, REP requires 
that the new variable already exists in 
the variable name table. To add a 
new variable to the table, simply 
use it in any BASIC statement, even 
in direct mode, (If you want to cre- 
ate a new variable SUM, for in- 
stance, you can just type SUM=0 
and press RETURN.) 

If you don’t include the option- 
al line number range, REP works on 
the entire program. If you specify a 
range of lines, it replaces the old 
variable name only within those 
lines. Watch out for this, since it 
may cause a conflict elsewhere in 
your program. 

Here are some examples: 
REP.CB CHECKBALANCE 


(Replace all occurrences of the vari- 
able CB with the new variable 
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name CHECKBALANCE.) 
REP CLIENTNAMES CNS 


(Replace all occurrences of the vari- 
able CLIENTNAMES with the new 
variable name CNS.) 


REP I( INDEX( 


(Replace all occurrences of the ar- 
ray variable I() with the array vari- 
able INDEX().) 


REP SUM TOTAL 3000,3999 


(Replace all occurrences of the vari- 
able SUM with the new variable 
name TOTAL within the subrou- 
tine in lines 3000 to 3999.) 
Variables are stored as one- 
byte tokens in Atari BASIC. REP 
looks up the old and new variable 
names in the name table to deter- 
mine their tokens, then replaces ev- 
ery old token (within range) with 
the new one. The old name remains 
in the name table (type XREF to see 
for yourself) and keeps the value it 
had at the time of the change. 


The VIEW Command 
BASIC’s PRINT statement lets you 
examine variable values in direct 
mode as you test and debug a pro- 
gram, but it can be cumbersome 
when you're juggling lots of vari- 
ables, especially subscripted vari- 
ables. Of course, there’s an easier 
way. 
DEBUT’s VIEW command lists 
all variables and their values, in- 
cluding strings and arrays, without 
requiring you to name each one. 
Type VIEW to quickly display the 
values, or use the optional output 
switch to generate hardcopy that 
you can analyze with the proverbial 
fine-toothed comb. 
Here is the format of the 
command: 
VIEW [/output device] [starting line,last 
line] 
where /output device is the optional 
switch for redirecting output from 
the screen; and starting line,last line 
is the optional range of line numbers. 
Here is the format of the VIEW 
command’s output: 
VARIABLE=value 
STRINGS current length,maximum length 
“string contents” 
ARRAY(rows,cols 
10 20 30 40 


2) 84, 16.18 
Om 55) 17) AL 


Scalar variable values are dis- 
played in a pretty straightforward 





manner—the variable name is fol- 
lowed by its value. Strings are listed 
with additional information—the 
current and maximum length. 
String contents are printed in 
quotes below the name. 

For subscripted variables, 
VIEW lists the row and column di- 
mensions corresponding to the in- 
dexes you assign with the DIM 
statement, plus one. (Because in- 
dexing starts at zero—ARRAY(0,0) 
is a valid array element—the actual 
size of each dimension is one 
greater than the value you give.) 
Values are listed by column and 
row; sample values are shown in 
the example above. A singly sub- 
scripted variable is really a one- 
column array; its values are listed 
vertically. If a string or array has 
not been dimensioned, only the 
name prints. Unused variables 
aren't listed at all. 

The output switch and range 
option work with this command as 
they do with all others. For 
example: 

VIEW/P 


(Prints a hardcopy of all the vari- 
ables and their values.) 


VIEW/P 200,300 


(Prints a hardcopy of the variables 
and values in lines 200 through 
300.) 


Additional Hints 

The DEBUT commands are an aid 
to debugging, but they won't do the 
whole job for you. Use them along 
with other techniques (such as trac- 
ing the program’s execution with 
temporary PRINT statements) to 
close the gap between what you’re 
telling BASIC to do, and what you 
want it to do. 

Since the optional disk output 
produced by these commands is 
compatible with any word processor 
that handles ASCII text, you can 
easily produce program documenta- 
tion with DEBUT, For example, you 
could save the XREF listing to disk, 
and use a word processor to add 
explanations of each variable. Every 
minute spent documenting a pro- 
gram pays off threefold should you 
ever have to go back and modify it. 

The DEBUT command formats 
are tolerant of extra spaces, and 
command words can be abbreviat- 
ed—just type the first letter fol- 





lowed by a period. In fact, the 
period alone is all you need for DIR. 
The output switch is unaffected by 
abbreviations—DIR/P, D./P, and 
./P all do the same thing. In addi- 
tion, the FIND command accepts 
abbreviated keywords as its target. 
For example, FIND FOR, FIND F., 
and F.F, all seek out the keyword 
FOR. Sound confusing? Experi- 
ment. You'll find the shortcuts 
which are most useful to you. 


Notes For ML Programmers 
It would be nice if DEBUT had a 
renumbering command, program 
trace capabilities, or even a few 
more DOS commands. Machine 
language programmers can add 
such new commands by patching 
entries into DEBUT’s command ta- 
ble, which reserves 25 bytes for just 
this purpose. 

A command table entry con- 
sists of your machine language rou- 
tine’s address minus one, followed 
by the command name. The address 
is stored in high byte/low byte or- 
der. The command name is in ASCII 
code exactly as you'd type it, except 
that the rightmost byte must have 
the most significant bit on (inverse 
video). Add entries starting at loca- 
tion 8149 (hex $1FD5), but don’t use 
more than the 25 bytes or you'll 
overwrite DEBUT. Your code can be 
appended to the DEBUT AUTO- 
RUN.SYS file by using the DOS 
copy with append feature. 

DEBUT does some preprocess- 
ing before your routine gets control. 
As a result, you'll be able to abbre- 
viate your commands, with DEBUT 
abbreviations taking precedence. 
The output switch works as well, 
opening channel 1 to the output 
device and storing the channel 
number at location 181 ($B5) before 
branching to your routine. If the 
command line requires further 
parsing, your routine will find it at 
location 1408 ($580); the offset to 
the first argument (if any) will be in 
location 242 ($F2). Your machine 
language routine should end with 
an RTS instruction if you wish it to 
return through DEBUT to BASIC. 

DEBUT calls on several rou- 
tines in Atari BASIC and accesses 
various BASIC tables whose ad- 
dresses have changed in the later 
releases, which accounts for the two 
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Custom 


Characters 
For Atari 
SpeedScript 


Charles Brannon 


Atari SpeedScript’s large-sized char- 
acter set with true descenders is de- 
signed for maximum readability. 
Since it is built into SpeedScript, 
though, it's difficult to change. Now, 
with the accompanying program, you 
can add your own custom font to 
SpeedScript—even special charac- 
ters for foreign languages. It works on 
any Atari 400/800, XL, or XE com- 
puter with at least 24K RAM and a 
disk drive. Disk File: CUSTCHAR 
BAS. 


When you're writing, you probably 
don’t think about the technical mir- 
acles that make word processing 
possible. The characters on the 
screen seem as fixed as those on 
paper, but they’re actually dis- 
played from a section of memory. If 
you can change this memory, you 
can change the shape, form, and 
order of the characters. 

Normally, the Atari’s character 
set is permanently and unalterably 
stored in Read Only Memory 
(ROM). But you can tell the video 
chip to look elsewhere for the char- 








substitute your own set. Atari 
SpeedScript uses just such a tech- 
nique, coupled with a special Atari 
character mode, to display large, 
well-formed characters. 

One way to design your own 
characters is to sketch them on grid 
paper, convert the resulting binary 
patterns into numbers, and then 
substitute these numbers in the sec- 
tion of SpeedScript that modifies the 
character set. 

Fortunately, there’s an easier 
way. You can use a character set 
editor (or font editor) to “draw” the 
desired characters with a joystick. 
The font editor converts the pat- 
terns into numbers for you and 
saves the new set on disk for later 
use. There are many font editors 
available for the Atari, but relative- 
ly few of them let you design char- 
acters for the unusual ANTIC 3 
mode that SpeedScript uses. This 
mode displays a taller character 
grid so you can design characters 
with true descenders (the protruding 
tails on letters such as j and y). 

“Atari FontMaker,” published 
elsewhere in this issue, lets you de- 
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acter modes, including ANTIC 
mode 3. The FontMaker article in- 
cludes some instructions for creat- 
ing SpeedScript ANTIC 3 characters, 
and also some tips for designing 
more readable characters. After de- 
signing a new character set with 
FontMaker, you can use the “‘Speed- 
Script Characterizer,” (CUSTCHAR 
.BAS) to create a new copy of Speed- 
Script with your custom font. The 
custom characters appear each time 
you load the modified copy of 
SpeedScript. 


Making A SpeedsScript Font 
If you want to convert a normal 
character set for use with Speed- 
Script (perhaps one that you've de- 
signed with another font editor), 
start by loading the set into Font- 
Maker. Press G to switch to the 
ANTIC 3 mode. (The G command 
cycles through the graphics modes, 
and the first mode after the default 
GRAPHICS 0 mode is ANTIC 3.) 
You'll recognize this mode because 
the normal characters appear split, 
with their lower portions shifted to 
the top of the character grid. 

Use FontMaker’s roll up com- 
mand (CTRL-cursor up) to move 
each character up by one line. Roll 
up automatically wraps the lower- 
case descenders. If you want to 
make two-line descenders such as 
those found in the SpeedScript font, 
roll the lowercase letters up by two 
notches, erasing the last line of any 
characters that intrude into the de- 
scender zone, such as the lowercase 
h. Then shift up (SHIFT-cursor up) 
all the uppercase characters by two 
lines, and add an extra line of defini- 
tion to each character so they have 
the same baseline as the lowercase 
characters. As you work, refer to the 
“quick brown fox” sentence dis- 
played by FontMaker to see how 
your characters match up. When 
you're done, save your new font on 
disk with the S (Save) command. 

Now you're ready to merge 
your redefined character set with 
SpeedScript. Run CUSTCHAR.BAS 
and insert the disk containing a 
copy of SpeedScript and type in the 
filename you use for SpeedScript 
(AUTORUN.SYS, for example). 
Characterizer loads SpeedScript into 
a memory buffer. 

Next, insert the disk containing 
your character set and enter its file- 
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name. After this character set is 
loaded, insert the disk that will 
store the new copy of SpeedScript. 
Type in the filename you'd like to 
call it. (For safety’s sake, be very 
careful not to replace your existing 
copy of SpeedScript. If you have to 
name SpeedScript as AUTORUN. 
SYS to run it with Atari DOS 2.0 or 
2.5, use another disk or rename the 
original copy of SpeedScript some- 
thing else before you begin.) 

Finally, boot up the new Speed- 
Script and behold your custom 
character set. Try typing all the 
characters to make sure they are 
well-formed. If you made a mis- 
take, you can always edit the char- 
acter set and reinstall it. 

Keep in mind that SpeedScript 
uses the heart character to pad out 
the end of each line with spaces. If 
you don’t want to see a screenful of 
hearts, make sure you've blanked 
out the heart character in your set. 
Also, SpeedScript normally uses the 
left arrow (cursor-left) for the return 
mark at the end of each paragraph, 
so you may want to change this to 
some personalized symbol. If you 
don’t want to see return marks, 
blank out this character, or perhaps 
change it to a single tiny dot so you 
can easily delete what would other- 
wise be an invisible character. © 
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The following Atari-related questions were 
drawn from COMPUTE!’s Readers’ Feed- 
back columns published from 1984-1987. 
Readers should note that the new XE mod- 
el computers are fully compatible with the 
XL series computers often mentioned in 
these questions. 


Atari XL Super POKEs 

I read that some Atari owners do not 
like the audible keyboard feedback 
(keyboard click). You can always turn 
down the volume, but this prevents you 
from hearing any other sound effects. 
This simple POKE will turn off the key- 
board click: POKE 731,1. POKE it with 
a zero to turn the click back on. 


Jeff Tjebckes 


This POKE works only on the new XL 
Atari models, not on the original 400/800 
computers. There is no easy software solu- 
tion for the 400/800, but this POKE works 
fine on the 1200XL, 600XL, and 800XL. 
There are many other useful POKEs on the 
XL computers. Remember that none of 
these POKEs will work with the older 
400/800 computers, so if you are writing 
programs for publication or sharing, keep 
this in mind. 

First try this one: POKE 622,255 
:GRAPHICS 0. This allows fine scrolling 
of GRAPHICS 0 screens. Instead of jump- 
ing up a line at a time, the screen will 
smoothly scroll 1/8 character at a time. 
Use POKE 622,0:GRAPHICS 0 to reset the 
scroll. You must always follow this POKE 
with GRAPHICS 0. 

POKE 756,204 enables the built-in 
international character set. Hold down 
CTRL and press some of the letters of the 
alphabet to see these new characters. Use 
POKE 756,224 to go back to the normal 
character set with the graphics characters. 
POKE 621,255 disables the keyboard, and 
POKE 621,0 reenables it. SYSTEM RESET 
will get you out of this mode if it gets you 
into trouble. You can read the HELP key 
with PEEK(732). Location 732 returns a 17 
when the HELP key has been pressed. You 
must POKE it with a 0 to clear it out after 
you've acted on the key. SHIFT and CTRL 
also affect the HELP key, returning 81 and 
145, respectively. 

All keys begin to repeat when you 
hold them down. To change the delay 
before the key begins to repeat, POKE 729 











lkeaders Feedback 


The Editors and Readers of COMPUTE! 


with the number of 1/60 seconds you 
want to delay. A value of 30 would be a 
half-second delay. The default is 48, or 
4/5 second. A POKE to 730 controls how 
quickly a key repeats once the repeat has 
begun. The delay between repeats is also 
measured in 1/60 seconds. The default 
here is about 1/10 second. 

If you want to take advantage of XL 
features, yet permit the program to run on 
the 400/800, you can check the operating 
system ID byte, found at location 65527 in 
ROM. There is a different number for 
every version of the Atari operating sys- 
tem. If this byte returns a value for the 
400/800, you can skip over the statements 
specific to XL models, Consult COM- 
PUTE! Books’ Mapping the Atari for a 
comprehensive guide to Atari memory, 
and the article “An Introduction to Atari 
PEEKs and POKEs” in The Atari Collec- 
tion, Volume 1, due to be released in a 
few weeks. 


Operating System PEEK(65527) 
400/800 Revision A 221, 87, or 243 
400/800 Revision B 230 

1200XL Revision A 10 

1200XL Revision B 11 

600XL 1 

800XL 2 


Atari 800XL 


Memory Expansion 
Can you use the memory expansion 
intended for the 600XL to expand the 
memory of the 800XL? 

Toby Buckalew 


The 600XL memory expansion brings the 
total memory of the 600XL up to the 
maximum of 64K. Although it would plug 
into the 800XL, this would be futile (and 
would confuse the computer), since the 
800XL already has 64K. Memory is not 
merely an add-on item—it has to fit cor- 
rectly into the computer's memory map. 
Since the memory map is full on the 
800XL, you would need some other kind of 
expansion memory that uses bank switch- 
ing or windowing to get more than 64K of 
system memory. You could never have 
more than 64K of memory at one time, but 
you could swap out (bank switch) portions 
of the expanded memory in a cartridge 
that allows this. Don't expect any com- 
mercial software to take advantage of such 
an unusual memory configuration, though. 











Atari USR 

I own an Atari 600XL, but don’t have a 
complete manual. What does the USR 
statement do? I’ve seen it in several 
programs, such as A=USR(1536). What 
is the 1536 for? Why can’t you enter 
USR(710) to change the color of the 
screen? 


USR looks like any other BASIC function, 
but is the gateway from Atari BASIC to 
machine language. It does not work like 
POKE or PEEK, which can be used to 
change and read memory locations like 
710, which holds the background color of a 
GRAPHICS 0 screen. An understanding of 
machine language is essential in creating 
your own USR calls, but there are many 
plug-in subroutines (published in our 
books and in COMPUTE!) that you can add 
to your program. 

For machine language programmers, 
USR lets you pass parameters (variable 
values or expressions) to the machine lan- 
guage program. A=USR(n,x,y,z) would 
start the 6502 executing the code at mem- 
ory location n (instead of executing the 
BASIC interpreter). Since there are three 
parameters in the example, the number 3 
will be the first item on the 6502 stack (use 
PLA to read a byte off the top of the stack 
into the accumulator). If there are no pa- 
rameters, a zero is used, and you must pull 
this zero off before you use RTS to return 
to BASIC. The rest of the parameters are 
converted to 16-bit unsigned integers, and 
placed in order on the stack. Each parame- 
ter becomes a two-byte number which is 
found on the stack high byte first, then low 
byte: 


The stack after the call A=USR 
(1536,5,65535,2562): 


Top of stack: 3 
0 


5 
255 
255 
10 
2 


The next two bytes are the return 
address —1 of the BASIC interpreter, since 
JSR (which is how USR calls the ML) 
stores this address on the stack. 

Since USR is a function, you can’t use 
it by itself, but must use a statement like 
X=USR(1536). The actual variable you 
use doesn’t matter, but the ML program 
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can pass a value back to BASIC by storing 
the low byte of the number in $D4 and the 
high byte in $D5. This value will be 
assigned to the variable used in the USR 
statement. 





Atari Attract Mode 
I own an Atari 1200XL. So far, I have 
programmed two games in BASIC, but 
there is one problem I haven't solved. 
After about 8-10 minutes of play, the 
screen starts to change colors. Is there 
any way to get around this annoyance? 
John Hnat 


The Atari computers incorporate the color 
shifting to protect the screen from dam- 
age. Normally, you have nothing to worry 
about, since TV images change constantly, 
but theoretically an image could burn 
itself into the phosphor if left displayed 
unchanged for a long period of time. Back 
in the early days of Atari computers, ru- 
mors about this problem were seized upon 
by the public and blown all out of propor- 
tion. To allay fears, all Atari machines 
have this color shifting protection built- 
in. If the keyboard has not been touched 
for 8.5 minutes, all the colors cycle at a 
reduced brightness. This constant color 
shift prevents any one image from burning 
into the TV screen. However, we have 
never seen a documented case of a home 
computer damaging a television due to 
long exposure. Incidentally, the color 
shifting is called attract mode, named 
after the way arcade games will play auto- 
matically to attract customers. 

Every four seconds, memory location 
77 is incremented by one. When it reaches 
128, attract mode starts. To prevent at- 
tract mode, POKE 77,0 periodically. If you 
want to preserve the intention of attract 
mode, perform this POKE only when the 
player makes some action, as in moving 
the joystick. If you are playing a game that 
does not disable attract mode, you can 
press any key to stop the color shifting. 
Sometimes a keystroke interferes with a 
program, but you can often press the in- 
verse video key (which doesn’t generate 
an ATASCII keystroke) twice to cancel 
attract mode while a program is running. 





Atari Monitor Hookup 
I have ordered a BMC monitor and an 
Atari 800XL. Very recently, I was told 
that the Atari is designed for use with a 
standard TV set. How can I make the 
Atari work with the BMC monitor. Will 
the monitor be totally useless? 
Benedict V. Sulit 


Although optimized for use with a televi- 
sion set, the Atari 800XL looks even better 
on a composite color monitor. You can 
also hook up a black-and-white (mono- 
chrome) monitor. You'll need a special 
cable that plugs into the round, five-pin 








DIN plug on the back of your 800XL. For a 
color monitor, get a cable that feeds the 
chroma (composite video) signal into Vid- 
eo In on your monitor. For a monochrome 
screen, you'll get best results using the 
LUMA (luminance) signal. Some cables 
bring out all five pins to RCA phono jacks. 
With trial and error you can easily find 
which wire controls which signal. You can 
get a video cable at your local computer 
store or possibly a TV/video store. 





Autobooting Atari 

Is there any way you can make a pro- 

gram run right after it has been loaded 

into your computer from tape or disk? 

This would prevent anyone from seeing 

the special codes in the program. 
Mark Zobel 


We assume you are using a password or 
are disabling the break key and system 
reset. If the program didn’t run automati- 
cally, anyone could LIST the program and 
remove the protection. Although you can't 
completely bar an experienced, enthusias- 
tic invader, you can make a program run 
automatically from disk when you boot up 
your system. See “Automate Your Atari” 
in COMPUTE’s Third Book of Atari. 

Although it is possible to create a 
boot tape that does the same thing, we 
don’t know of a specific program. 





Atari Checksum Errors 
Ihave had my Atari computer for a year 
now, but I still have a few unanswered 
questions you might be able to help me 
with. Sometimes when I load a pro- 
gram off iny cassette, I get something 
called a “serial bus data frame check- 
sum error.’” What does this mean, and 
how can I remedy it? Also, when I get 
an error in the middle of the loading 
process, is there any way I can retrieve 
the portion that did load correctly? And 
is there a way to verify Atari SAVEs? 
Jeff McCain 


The “serial bus data frame checksum er- 
ror” and its cousin, “serial data frame 
overrun,” are just Atari’s way of telling 
you that the computer encountered a tape 
error. The tape drive is very sensitive to 
errors in timing—if a tape is stretched in 
the middle, it will throw off the bit timing. 
You can also get this error if you didn’t 
allow enough leader when you positioned 
the tape for CLOAD. 

An incomplete program can be a ma- 
jor problem. Due to the way Atari pro- 
grams are stored, BASIC must know how 
to find the exact end of a program. A 
partial program is often cut off in the 
middle of a line, and when BASIC scans to 
find the end of the program, it locks up, 
not finding it. So to prevent this problem, 
a faulty LOAD causes the partial program 
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to be NEWed. If you store programs with i] 
LIST “C:”, you can then ENTER “C:” to 
retrieve it. If there is an error, you will 
still be left with a partial program. You 
can continue with ENTER “C:”, and you 
may pick up more and more of the listing. 

ENTER can also be used to verify a 
LISTed program. If you ENTER a program 
that you have just LISTed, the program in 
memory will not be lost. If it ENTERs 
without an error, you've verified that the 
data is stored correctly. Otherwise, you'll 
still be left with the program in memory, 
so you can try again. LIST and ENTER, 
though, are slower and use more tape 
space than CSAVE and CLOAD. 





Rainbows For Atari 
I own an Atari 800 and I am perplexed 
about how to access all the colors in 
graphics mode 8. The only graphics 
color I can get is white. How do you 
access the other colors? 

Rod MacPherson 


GRAPHICS 8, like GRAPHICS 0, is a two- 
color mode. You can display a character or 
a pixel in either the background color or a 
different shade (luminance) of the back- 
ground color. So the only nonbackground 
color you get in GRAPHICS 8 is COLOR 
1. Due to the way TV pictures are drawn, 
the tiny pixels can appear in different 
colors, depending on what column they 
are in (this is often called artifacting). You 
can extend your color options this way, 
but we can’t go into the details here. There 
is plenty of information on artifacting and 
other graphics modes in COMPUTE!’s 
First Book of Atari Graphics. 





Cassette Filenames And 
Built-In BASIC 


I own an Atari 400 computer. Can you 
specify a filename for the 410 program 
recorder? Also, how do you run a pro- 
gram that asks you to remove the 
BASIC cartridge on the 600XL? Since 
BASIC is built-in, it seems like it might 
be impossible. 

Doug Stevens 


The tape operating system could have 
been written to allow filenames, but since 
tape access is sequential and so slow com- 
pared to a disk drive, filenames are not 
especially useful. You can instead use the 
tape counter to find and position pro- 
grams. Be sure to leave plenty of space 
between programs, since the tape counter 
is not precise, and you could inadvertent- 
ly write over a program. 

Some programs require 48K, 8K of 
which is not available with a cartridge 
plugged in. These programs check for a 
cartridge and ask you to remove it before 
the program will run. The 600XL has only 
16K, though, so this shouldn't be a prob- 











lem. In any case, you can effectively re- 
move (disable) the built-in BASIC by 
holding down the OPTION key while you 
turn on the computer. 





New Atari Graphics Mode? 


I wrote a program that puzzles me: 


10 GRAPHICS 9016:POKE 710,0 

20 X=INT(RND(0)*318):¥ =INT 
(RND(0)*191) 

30 PLOT 159,95 

40 COLOR Y:DRAWTO X,Y 

50 GOTO 20 


What is graphics mode 9016? When I 
break in and rerun the program, the 
previous picture is not erased! Also, 
sometimes it would suddenly clear the 
screen. Why? Is there something wrong 
with my computer? 

Gordon E, Gizowski II 


No, your computer is fine. You've just 
revealedsome of the peculiarities of 
BASIC and the operating system. First, 
graphics modes are specified with a num- 
ber from 0 to 15. If you add 16 to the 
number, the split screen will be disabled. 
If you add 32 to the number, the screen 
will not be cleared when the graphics 
mode is entered. But anything above 
15+16+32 is just chopped off. In binary 
terms, only the lower six bits of the mode 
number are used. So GRAPHICS 71 is the 
same as GRAPHICS 7+ 64. Since 64 (bit 6) 
is not used, GRAPHICS 71 is the same as 
GRAPHICS 7. GRAPHICS 9016 is the 
same as 8+32+16+8960. Since 8960 is 
outside the range, it is ignored, and you 
get 8+32+16 (56), which is GRAPHICS 8 
with no split screen. The 32, as men- 
tioned, prevents the screen from being 
cleared when GRAPHICS 8 is set up. A 
portion of the previous picture may have 
been destroyed, though, if you have 
changed modes (such as from GRAPHICS 
8 to GRAPHICS 0). 

The reason the screen was sometimes 
cleared is in line 40. You PLOT and 
DRAWTO random X,Y coordinates, but 
also use the Y coordinate for the color 
number. COLOR also chops off the part of 
a number that is not used. In GRAPHICS 
8, only COLOR 1 and COLOR 0 are valid, 
so that odd numbers count as COLOR 1, 
and even numbers work as COLOR 0. 
PLOT is the same as PRINTing the CHR$ 
value of the color at the screen X,Y posi- 
tion (try using COLOR and PLOT with 
GRAPHICS 0, 1, and 2 to see the effect). If, 
however, the color number is 125, it is 
interpreted as CHR$(125), which is the 
same as the code for clear screen (CTRL- 
CLEAR). So COLOR 125:PLOT x,y will 
clear the screen. Your program is interest- 
ing, but to get the intended effect, you 
should use a different variable for the 
color. For example: 


25 C=INT(2*RND(0)). 
40 COLOR C:DRAWTO X,Y 
es 











File Structure On Atari 
I have an Atari 800 and am trying to 
write a BASIC program to access re- 
cords ina file. If 1 open a file with a 9 to 
append the file, it will use the entire 
sector to store the data. If I open the file 
with a 12, I can write to the entire 
sector, but eventually I will come up 
with an EOF (End Of File) error. Is there 
any way to get around this problem? 
Also, are there any good books (besides 
the DOS manual) on file and record 
structure for the Atari disk? 

Charles Bentivegna 


The OPEN command has four parameters: 
OPEN IOCB#,access,aux,”filename” 


IOCB# is a number from 1 to 7. There are 
eight Input/Output Control Blocks on the 
Atari. Each IOCB keeps track of an indi- 
vidual file. IOCB #0 is reserved for use by 
the screen editor (INPUT and PRINT). 
IOCB #7 is used for LPRINT, CSAVE, 
SAVE, LOAD, and CLOAD. When you 
OPEN a file to a particular IOCB, you use 
the same number when accessing the file 
with PRINT#IOCB; data or INPUT# 
IOCB, variable. 

The second parameter, access, is 
either 4 (OPEN for read), 8 (OPEN for 
write), 12 (OPEN for read and write), or 9 
(OPEN to append). The aux byte is usually 
just 0. Access numbers 4 and 8 are 
straightforward. OPEN for read lets you 
GET or INPUT from that file, but not 
PRINT or PUT to it. Access number 8 lets 
you create a file, or send data out to a 
device like a printer with PUT and 
PRINT. With a disk drive, using access 
number 8 will either create a new file or 
replace a previous one. Access number 12 
lets you read and write to an existing file. 

It's a little strange. You can keep 
reading the file until you get to the place 
you want to change, then start writing. 
Once you start writing, however, you can 
no longer read, since you have started to 
replace a portion of the file. With access 
number 9, you can only write to the end of 
@ file. To keep things simple, the data you 
append to an existing file starts on a new 
sector, rather than filling up the remain- 
der of the last sector used by the file. If you 
add short items to files with access num- 
ber 9, you can waste a lot of disk space 
over the long run. 

The only way you can both read and 
write independently of the disk is to use 
random access files. With NOTE, you can 
store the relative sector number of each 
block as you write the file to the disk. You 
can then refer to the information you 
stored with NOTE, and use POINT to 
jump directly to any sector in that file. 
You can write a single sector (record) 
independently of the rest of the file, and 
instantly skip to any sector without hav- 
ing to sequentially read through all the 
previous data. We cannot go into detail on 








the use of NOTE and POINT here, but the 
DOS 2.0S Manual has most of the infor- 
mation you need. Another source for de- 
tails on the working of DOS is Bill 
Wilkinson's Inside Atari DOS, available 
from COMPUTE! Books. 





Atari Peripheral Adequacy 
I have an Atari 400 computer and an 
Atari 410 cassette recorder. I’m plan- 
ning to buy an Atari 800XL computer, 
and I was wondering if the cassette 
recorder would work on the Atari 
800XL computer. 

Isaac Thornton Scott 


As long as your recorder is still working 
fine with your 400, there should be no 
problem using it with an 800XL. You may 
want to have the tape heads cleaned and 
demagnetized, even realigned to give you 
a fresh start with your new computer. All 
400/800 peripherals we know of will work 
just fine with the 600XL and 800XL 
computers. 





Atari Amnesia 
Irecently bought an Atari 800XL which 
claims to have 64K, but which seems to 
have only 48K user memory. The other 
16K supposedly is available only with 
certain software programs. Which 
ones? I am also having troubles with 
the memory test. The other day I 
bought a game requiring at least 48K. I 
tried to load it on my 1050 disk drive, 
but the picture is distorted. I tried again, 
but got the same results. So I tried the 
memory test by holding down the OP- 
TION key while turning on the com- 
puter. The ROM checks green. So does 
all my RAM, up to 44K. I checked it 
again, still 44K. What do I do? 

Steve Whitlow 


It sounds like your computer is behaving 
normally, but the software may not be 
compatible-with the 800XL. Check with 
the dealer who sold you the program or 
with the software publisher. Some pro- 
grams designed for the older Atari com- 
puters have trouble running on the newer 
XL machines because of changes in the 
computer's operating system. The fault 
still lies with the software, though, be- 
cause from the beginning Atari made it 
clear that programmers should follow cer- 
tain rules to insure compatibility with 
future models. 

One solution might be to obtain a 
translation disk which, in effect, tempo- 
rarily converts your XL into an older- 
model Atari 800. The disks are available 
from Atari for a nominal fee and from 
some independent companies. 

The memory discrepancies you dis- 
covered are unrelated to the software prob- 
lem. The Atari 800XL does indeed have 


el 
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Bit Bit Decimal 
Position Value Equivalent 

0 0 0 

0 1 il 

1 0 0 

1 1 2 

2 0 0 

2 1 4 

3 0 0 

3 1 8 
4-6 2 = 

7 0 0 

7 1 128 


64K of Random Access Memory (RAM), but 
as with the Commodore 64 and 64K Apple 
Ile, not all of this RAM is immediately 
accessible. All these computers use 6502- 
family chips for their Central Processing 
Units (CPUs). The 6502 is limited to ac- 
cessing, or addressing, a total of 64K of 
memory at a time. Part of this 64K must be 
allocated for internal programs necessary 
to operate the computer. This includes the 
operating system and BASIC language. 

The Atari operating system, stored in 
Read Only Memory (ROM), requires 10K 
of space. Additional ROM space is used 
for the international character set and 
self-test routines, BASIC, when selected, 
uses a little over 8K of space. The input/ 
output chips need 2K of address space, 
since they are controlled as if they were 
memory locations. This leaves less than 
40K of RAM when using BASIC. Roughly 
the same amount of memory is available 
for BASIC on a Commodore 64 or 64K 
Apple Ile. 

If you switch off BASIC in your 
800XL (equivalent to unplugging the 
BASIC cartridge on the older Atari 400, 
800, and 1200XL computers), 48K of RAM 
is directly addressable. To switch off 
BASIC, hold down the OPTION button 
when powering up. 

Don’t think you're being misled by the 
64K RAM claim; it’s there, but it takes 
some special programming to access it. Not 
many commercial programs take advan- 
tage of this extra memory, though, because 
they would not be compatible with the 
large number of older 800s still in use. 

If you have some programming expe- 
rience, you can reach this additional 
memory with your own programs. The 
PIA chip in your Atari, used for the two 
joystick ports, also helps control memory 
mapping and other special XL functions. 
These functions are controlled with mem- 
ory location 54017 (PORTB, $D301), for- 
merly used on the 400/800 to read 
joystick ports 3 and 4, which are omitted 
on the XL models, (Incidentally, if you try 
to read the shadow registers for joysticks 3 











Function 


Disable operating system ROM, enable RAM 
from $C000 to $FFFF. 

Enable OS ROM (default). 

Disable built-in BASIC ROM. 

BASIC off, RAM on at $A000-$BFFF. 
Turn on LED #1. 

Turn off LED #1. 

Turn on LED #2. 

Turn off LED #2. 

Not presently used. 

Enable self-test ROM. 

Disable self-test ROM, enable RAM at 
$5000-$57FF (default after power-up 
complete). 


and 4, or use STICK(2) or STICK(3) in 
BASIC, the values returned will be those 
of joystick ports 1 and 2.) The eight bits at 
$D301 control eight functions (see chart). 

Add up the decimal values of the 
functions you want to enable or disable, 
then store the sum into location 54017. Of 
course, you would not want to turn off 
BASIC or the operating system with a 
POKE from BASIC (without a language, 
operating system, or controlling program, 
the computer would be reduced to a prism 
of pure memory with nothing to remem- 
ber). Feel free to flicker the LEDs (found 
only on the 1200XL) from BASIC, but 





memory mapping should always be done 
with a machine language program. 

With both BASIC and the operating 
system disabled, there is free RAM from 
$A000 to $FFFF, 16K of additional RAM 
space. Well, almost 16K. The computer is 
pretty useless without its video and input/ 
output chips, so they are kept active from 
$D000 to $D7FF, leaving this 2K of RAM 
inaccessible. 

If you're going to tackle the job of 
accessing all of the Atari's hidden RAM, 
there’s another consideration, too. The 
video chip generates a non-maskable in- 
terrupt (NMI) every 1/60 second so that 
the operating system can update screen 
variables. This NMI canno: be disabled, 
so if the operating system is out to lunch 
when the interrupt happens, the 6502 
tries to make an indirect jump through the 
NMI vector at $FFFA, finds nothing of 
value there, and crashes. So before you 
switch out the RAM, write the address of a 
nominally functional NMI routine into 
SFFFA and $FFFB. This can simply point 
to an RTI (return from interrupt) so that 
NMIs will be ignored. 

Remember also that with the operat- 
ing system and interrupts disabled, you 
cannot make use of any of the shadow 
registers for input/output. You must store 
directly into the hardware locations. And 
naturally, you have to reenable the oper- 





ating system to call routines like CIO 
(Central Input/Output). 
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Atari Graphics 2 vs. 0 
I have an Atari 1200XL. I have trouble 
seeing, so I prefer to use the largest size 
text mode, GRAPHICS 2. Is it possible 
to use this mode in place of GRAPHICS 
0 for entering, editing, and running 
programs? 

Wanda Ellis 


First, you should be aware that GRAPH- 
ICS 2 interprets text characters differently 
than GRAPHICS 0. As set up, only upper- 
case characters are permitted. Lowercase 
characters, inverse characters, and in- 
verse lowercase characters all appear in 
distinctly different colors than uppercase 
text, but still appear as uppercase. The 
screen editor is set up to work with 
GRAPHICS 0, which has 40 columns and 
24 lines. GRAPHICS 2 has 20 columns 
and 12 lines. It is possible to use GRAPH- 
ICS 2 in place of GRAPHICS 0, in a 
limited way. Enter this line to see the 
technique: 


GR.2+16:POKE 87,0 


The +16 disables the text window, and 
POKE 87,0 fools the Atari into thinking it 
is in GRAPHICS 0. In this mode you will 
be able to type lines and even cursor 
around and make changes. The bottom half 
of the screen will be invisible, so scrolling 
will be tricky. Also, the cursor will only be 
visible when resting on a character. It 
wouldn't be too hard to write a machine 
language editor for using large size charac- 
ters (perhaps with GRAPHICS 7). 





Atari Self-Loading Tapes 
Ihave tried to load a machine language 
cassette tape by holding down the 
START button while turning the ma- 
chine on, waiting for the beep, and 
hitting RETURN. The program starts 
loading into the machine, but I get a 
BOOT ERROR message. Why? What is 
the proper way to do this? 

Geoffrey C. Bennett 


Two possibilities exist. The most obvious 
explanation is that your tape is defective. 
But it is more likely that you have a disk 
drive attached and turned on. After the 
tape is successfully loaded, the Atari then 
tries to boot the disk drive. With no disk in 
the drive, you get the BOOT ERROR. 
Turn off the drive or disconnect it when 
you load a boot tape. 

Also, many machine language pro- 
grams on boot tapes won't work with the 
BASIC cartridge plugged in. Try removing 
BASIC before loading the tape into Atari 
400, 800, and 1200XL computers. On a 
600XL or 800XL, you can disable the 
built-in BASIC by holding down the 
OPTION button. (Therefore, to auto-boot 
with a 600XL or 800XL, you would simul- 
taneously hold down OPTION and 
START while switching on the computer.) 




















Atari Memory Map 
Is there a book that explains the memo- 
ty locations for Atari computers? 

Dan Lguyen 


There are several books you may find use- 
ful. When the original Atari 400 and 800 
were introduced in 1979, none of their 
advanced features were documented and 
Atari kept the information secret. Shortly 
afterward, however, Atari changed its poli- 
cy and several volumes were released con- 
taining much detailed information for 
advanced programmers, These include the 
Atari 400/800 Hardware Manual, the 
Atari 400/800 Operating System Man- 
ual, the Atari 400/ 800 Operating Sys- 
tem Source Listing, and De Re Atari. 
These books are heavy reading, but togeth- 
er they reveal almost everything there is to 
know about the Atari 400 and 800 (most of 
the information is applicable to the newer 
XL models as well). The books can still be 
obtained from some local Atari dealers, 
user groups, and from Atari itself. 

If you're interested mainly in a mem- 
ory map, the most detailed one is pub- 
lished in Mapping the Atari from 
COMPUTE! Books. Other COMPUTE! 
Books you might want to investigate are 
The Atari BASIC Source Book, which 
contains the complete source code for 
Atari BASIC; Inside Atari DOS, which 
contains the complete source code for the 
Atari Disk Operating System (version 
2.0S); COMPUTE!'s Third Book of Atari, 
which has a 1200XL memory map; and 
The Atari Collection, which includes a 
section explaining the most useful memo- 
ry locations in Atari computers. 





Missing Atari Memory? 
When I run the memory test on my Atari 
800XL, it seems to check only the first 
40K of RAM. There are no red blocks 
anywhere on the screen, but it refuses to 
check the last 8K of user RAM. When I 
check RAMTOP with PEEK(106), it re- 
turns a value of 160. If I am not mistak- 
en, 48K of RAM should return a value of 
192. The only other symptom is an 
above-average amount of keyboard 
lockup. What's wrong here? 

Dave Nessell 


Either you did not disable BASIC on 
powerup by holding down the OPTION 
key or you have a cartridge installed. A 
cartridge or the built-in BASIC uses the top 
8K of your 48K of memory. To free up this 
8K of RAM, disable BASIC or remove the 
cartridge when running the memory test. 

The keyboard lockups are probably 
unrelated to the results of the memory 
test. Instead, BASIC is most likely to 
blame. The first Atari BASIC cartridge 
suffered from a lockup bug that was sup- 
posedly fixed in revision B BASIC, the 
version built into the 600XL and 800XL. 














Unfortunately, the fix only made the prob- 
lem worse. (See “INSIGHT: Atari,” COM- 
PUTE!, May and June 1985.) 

Atari has finally eliminated the lock- 
up bug for good in revision C BASIC. This 
version is built into the new 130XE com- 
puter and is available on cartridge for 
earlier machines. To obtain a cartridge, 
send $15 to: 


Atari Corp. 
Customer Relations 
390 Caribbean Drive 
Sunnyvale, CA 94088 





Better Atari 


Color Combinations 
Please tell me the proper POKE or SET- 
COLOR command to make my Atari 
800XL’s text blue on darkest blue, blue 
on black, white on black, or any other 
combinations that might be easier on 
one’s eyes. Will leaving the computer in 
these modes for long periods of time 
damage anything? Is there any way to 
make DOS 3.0 work in these altered 
text colors? 

Jeb Branham 


It’s quite easy to change the Atari screen 
colors. The statement SETCOLOR 1,- 
color,brightness sets the brightness level 
of text. The color value is irrelevant, since 
text is always the same color as the back- 
ground (simply a different shade). The 
brightness value must be an even number 
from 0 (darkest) to 14 (brightest). Use SET- 
COLOR 2,color,brightness to control the 
background color. The color value can be 
any number from 0-15, and the bright- 
ness can be any even number from 0-14. 
You can also set the border color with 
SETCOLOR 4,color,brightness. 

For instance, the statements SET- 
COLOR 1,0,10: SETCOLOR 2,9,0 pro- 
duce light blue on dark blue. Blue text on a 
black background is not possible, since 
both screen and character color must be 
the same color. However, some shades of 
the same color look like different colors. 
For example, bright red-orange looks like 
yellow, and white is actually “bright 
black.” Thus, SETCOLOR 1,0,10: SET- 
COLOR 2,0,0 gives you white text on a 
black screen. 

Many people find it easier to read 
black text on a white background, since 
this combination simulates the appear- 
ance of type on paper. Use SETCOLOR 
1,0,2: SETCOLOR 2,0,10. You may have 
to fiddle with the brightness numbers to 
get the contrast right. Unfortunately, 
these color changes are transient. The 
normal screen colors return when you 
press SYSTEM RESET, change graphics 
modes, or go to DOS. To change the screen 
colors of the DOS menu, you'd have to 
disassemble DOS to find the instruction 
which sets the colors and then alter the 














instruction yourself. 

No color combination will damage 
your TV or monitor unless you leave very 
bright text on the screen for a significant 
period of time (such as overnight). Atari 
computers have a built-in protection fea- 
ture against burn-in: If you don’t press 
any keys for about nine minutes, the com- 
puter automatically enters attract mode, 
in which the screen colors continually 
cycle at 50 percent brightness until you 
press a key. 





Atari Disk Directories 
I have an Atari 800XL and an Atari 
1050 disk drive. I would like to know if 
you could get a disk directory without 
using DOS. It is very inconvenient to 
load DOS every time I want to see my 
programs. 

Anthony Bonhomme 


Try the following direct-statement line. It 
lists the directory in BASIC without eras- 
ing the program in memory. It always 
returns an ERROR 136. To keep things 
clean, type CLOSE#1 or END after you 
see the error message. 
OPEN#1,6,0,"D:*.*”:FOR X=1 TO 

1E9:GET#1,A:PRINT CHRS(A); 

:NEXT X 


You might also want to consider ob- 
taining a different DOS for your com- 
puter. There are several good DOS 
packages available from independent 
companies which offer disk directories in 
BASIC and many other features. Usually 
these DOS programs are compatible with 
Atari DOS disks as well. 





Atari Disk RAM? 

I have an Atari 600XL and 1050 disk 

drive. My 600XL has 16K RAM. Does 

my disk drive add any RAM to the 

computer? If so, how much does it add? 
Doug Howard 


Strictly speaking, you lose some usable 
computer memory when operating an 
Atari (or most other computers) with a 
disk drive. To use the drive, you must load 
DOS (the Disk Operating System) into 
memory. DOS is a machine language pro- 
gram that’s roughly 6K long. Therefore, 
when DOS is present, you lose memory 
that's otherwise available. 

However, in a broader sense the disk 
drive expands system RAM tremendously. 
A disk drive lets you run much larger 
programs (and process much more data) 
than the computer could otherwise han- 
dle. For example, a program that's too big 
to fit into memory can be broken into two 
separate parts or modules. When the first 
program module is finished, it loads and 
runs the second module. The second mod- 
ule could in turn load a third, and so on. 
Since the program modules link them- 
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selves together as they go, this technique 
is often called chaining. 

Though many BASIC programs store 
data within the program itself (usually in 
DATA statements), you can also store data 
outside the computer in a disk file. An 
Atari 1050 drive with DOS 2.5 or 3.0 
stores about 126K of data on each disk. An 
810 drive (or 1050 drive with DOS 2.0 or 
2.5 formatted for single density) stores 
about 88K on a disk. Of course, the com- 
puter’s memory can't hold that much data 
all at once. But it can access parts of it 
whenever it wants. When one disk fills up 
with data, you start filling another, and so 
on. In this sense, the disk drive extends 
system memory to infinity. 





DiMensioning Atari Memory 

Ihave an Atari 800XL and would like to 

know what the DIM statement does. 
Lenny DiChiara 


The Atari treats strings and arrays some- 
what differently than computers with Mi- 
crosoft BASIC. In Atari BASIC, the DIM 
(dimension) statement reserves memory for 
numeric arrays or string variables. String 
arrays are not supported. However, strings 
are not limited to 255 characters as in 
Microsoft BASIC—they can be of any 
length, up to the limit of available memory. 
In Atari BASIC, the following state- 
ment reserves memory for a one-dimen- 
sional numeric array of 51 elements: 


10 DIM A(50) 


Notice that the number of elements 
reserved is always one greater than the 
number in the DIM statement. That's be- 
cause the first element is addressed as A(0) 
instead of A(1). You could fill the array 
with a statement like this: 


20 FOR X=0 TO 50:A(X)=50-X:NEXT X 


You can also DIM a two-dimensional 
numeric array. Instead of a list, a two- 
dimensional array is like a list of lists. You 
may prefer to think of a two-dimensional 
array as a table, accessed by row and 
column. For example, to store a tic tac toe 
board, you might DIMension a 3 x 3 array: 


10 DIM TICTACTOE(2,2) 


Remember that this actually reserves 
a 3x 3 array, since you must count ele- 
ment 0. 

At this point, Atari BASIC diverges 
from Microsoft BASIC. You cannot DI- 
Mension an array of strings with a state- 
ment such as DIM AS$(10) or DIM 
AS$(10,10). Instead, DIM A$(10) reserves 
memory for a string variable A$ contain- 
ing 10 characters. All string variables 
must be DIMensioned in Atari BASIC 
before they are referenced in the program. 

Atari BASIC also addresses substr- 
ings differently than Microsoft BASIC. 
There are no LEFTS(), MIDS(), or 
RIGHTS$() functions. Instead, you access 











the characters directly. Try this example: 


10 DIM A$(10) 

20 A$="APRICOTS” 
30 PRINT A$ 

40 PRINT A$(1,4) 

50 PRINT A$(5,10) 
60 PRINT A$(1,1) 


When you run this program, the 
screen displays: 
APRICOTS 
APRI 
COTS 
A 


Line 30 prints the whole string. Line 
40 prints the substring (1,4) consisting of 
the first four characters of A$. Line 50 
prints the substring (5,10) consisting of 
the last six characters of A$ (the last two 
characters are blanks because APRICOTS 
is only eight characters long). And line 60 
prints the substring (1,1) consisting of a 
single character, A, You can print (or 
replace) any substring with this method, 
and even simulate string arrays. 

A few peculiarities: Arrays are not 
cleared out after a CLR or RUN. CLR or 
RUN both unDIMension an array, but the 
elements still contain their previous val- 
ues, or garbage. Don't count on a string 
being blank, or a numeric array to contain 
zeros. You may need to clear out the array 
yourself. For an 11-element numeric ar- 
ray, you'd use a statement like this: 


FOR X=0 TO 10:A(X)=0:NEXT X 


You can quickly clear out a string 
with this statement: 


A$=CHRS(0):AS(LEN(A$)) = AS 


Also, you cannot directly READ or 
INPUT data into an array. The statement 
INPUT A$(5) or READ A(X) is illegal; 
instead use INPUT T$:A$(5)=T$ or IN- 
PUT T:A(X)=T. 


Atari Disk Unfix 
I own an Atari 130XE and a 1050 disk 
drive. I recently purchased the game 
Summer Games, which worked perfectly 
when I played it. Then I used a DOS 2.5 
utility called DISKFIX.COM. One of the 
choices in this program was VERIFY 
DISK, so I thought I should use it to 
make sure the disk contained no bad 
sectors or files. While it was verifying, 
the computer flashed the message BAD 
LINK IN FILE 13—DELETING. When I 
ran the game again, the gymnastics 
event didn’t work. Any suggestions on 
how I might recover the file? 

M. Roberts 


The DISKFIX utility which comes with 
DOS 2.5 is a very powerful utility, which 
tries very hard to recover all the files that 
it can. The reason it didn’t work in this 
case is most likely due to copy protection. 
The copy-protection schemes used on 
many commercial disks often involve 








changing the sector link information on 
the disk. Apparently, DISKFIX thought 
that your disk was scrambled, and it did 
its best to correct the link information. If 
you write to the manufacturer of your 
game, perhaps they can suggest a way to 
recover the lost file. 

Disks don't get scrambled very often. 
When they do, it’s usually because a file 
wasn't closed after it was opened for writ- 
ing. Unless you're experienced with disk 
programming, you should use disk utilities 
only as a last resort. Caution is particularly 
important if you're trying to repair a com- 
mercial disk. If possible, it’s best to make a 
copy of the disk and run the utility on the 
copy rather than the original. If the utility 
does something unexpected, you'll at least 
be no worse off than when you started. 


Interrupts And De Re Afari 
We are writing a game for the Atari 800 
and we intend to use vertical and hori- 
zontal blank interrupt routines for a hi- 
res arcade sequence with extensive 
keyboard input. However, we heard 
that the keyboard click routine messes 
up the VBI. How is the keyboard click 
turned off? We have found several ref- 
erences to a book called De Re Atari 
which supposedly addresses this prob- 
lem and several others. We can’t find it 
and we don’t know who published it. 
Can you help? 
Richard Power 
Timothy Power 
David Lanphear 


First, a bit of explanation. Vertical blank 
routines and horizontal blank routines 
have some important differences. Since 
the electron beam which displays graphics 
moves more quickly across the screen than 
it does down the screen, a horizontal blank 
interrupt routine is shorter and more sen- 
sitive to time variations than a vertical 
blank interrupt routine is. Thus, keyboard 
clicks (which time their sound by waiting 
for horizontal syncs) throw off horizontal 
blank interrupts but they do not disrupt 
vertical blank interrupts, or VBIs. If you 
can manage with only using VBIs, you 
don't have to worry about this problem. 
It’s only the key-click sound, not the 
keypress itself, which disrupts the horizon- 
tal blank interrupt. One solution is to 
avoid the keyboard handler and read the 
keys with PEEK. Location 764 ($2FC) holds 
the value of the last key pressed. The value 
in 764 is a keyscan code which differs from 
both screen codes and ATASCII codes. 
POKE 764,255 to clear this location. 
The book De Re Atari was published 
by Atari; it was written by the Software 
Development Support Group, which in- 
cluded Chris Crawford, Lane Winner, Jim 
Cox, Amy Chen, Jim Dunion, Kathleen 
Pitta, Bob Fraser, and Gus Makreas. This 
book appears to be out of print and is no 
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longer sold by Atari. However, at the time 
of this writing (November, 1986) we con- 
firmed that copies are still available for 
$9.95 from San Jose Computer, 1844 Al- 
maden Road, Unit E, San Jose, CA 95125. 
This company states that they have many 
copies left, but you may want to call first 
before you order one. The phone number is 
(408) 723-2025. ; 


Computer Laryngitis 
I own an older model of Atari, the 
1200XL. As advertised when I bought 
it, the computer was said to have a 
voice synthesizer. However, I have not 
been able to use it. Do I have to use 
some special software or can I get voice 
synthesis from BASIC? Also, can the 
synthesizer sing? 

Chris Macy 


The 1200XL was the first of the XL line of 
Atari computers. Although it featured a 
few new innovations over the Atari 800, it 
did not meet with wide consumer accep- 
tance and wes discontinued within a year 
of its introduction. The 800XL and 600XL 
became the new high- and low-end ma- 
chines, respectively. For a while, Atari 
planned to introduce computers called the 
1400XL and the 1450XLD. Both of these 
models were supposed to offer easy-to-use 
speech synthesis. Before the 1450XLD was 
finally canceled, the designers were plan- 
ning to route the speech through the long- 
awaited AMY sound chip (which now may 
show up as an enhancement for the ST 
line), allowing the computer to “sing.” 
Unfortunately, the 1450XLD (and the 
65XEM, another computer designed to use 
the AMY chip) never made it to the store 
shelves, 

At present, the Amiga is the only 
home computer which includes built-in 
speech synthesis. Although speech is not 
built into your computer, hardware and 
software speech synthesizers are sold for 
the Atari computer line and other ma- 
chines, as well. We've even seen a limited 
but functional public domain speech syn- 
thesizer for the Atari ST. 

As a technical matter, it’s actually 
somewhat easier to make a computer sing 
than it is to make it talk: It is simpler to 
create a steady musical tone than is to 
produce the extremely complex sounds 
that make up human speech. Some elec- 
tronic music synthesizers can generate a 
passable imitation of a human voice tone, 
but none of them can talk. 

As a practical matter, speech-specific 
voice synthesizers don't sing very well. 
Just for fun, one of our programmers spent 
some time trying to make the Amiga’s 
built-in speech synthesizer sing “Happy 
Birthday,” using the synthesizer’s pitch 
controls to change from one note to anoth- 
er in Amiga BASIC. The results were 
amusing, but not very satisfactory. Spoken 








words require sounds (known as pho- 
nemes) that change in complicated ways 
over very short time periods. Since speech 
phonemes aren't designed for music, they 
don't sound convincing in a song, even if 
you change the pitch to produce different 
notes. It’s possible, of course, to have a 
voice synthesizer that handles both speech 
and music, but that capability would have 
to be built into the program. 





2 Times 8 Is Not 16 

Is it possible to link two Atari 400 com- 
puters together through the I/O port? If 
so, would the two memory capacities 
combine to become 16K? Which key- 
board should I use to type in programs? 
Are there any dangers or complications? 


Michael Zucca 


Although it is physically possible to con- 
nect two Atari computers (or two Commo- 
dore 64s, for that matter) through the 1/O 
ports, it would serve no useful purpose to 
do so. In fact, it may even damage one or 
both of the computers. 

The Atari serial ports are designed to 
communicate with special “intelligent” 
peripherals. There is a protocol—a speci- 
fied means of communication—that any 
peripheral must follow in order to be rec- 
ognized. In the case you suggest, neither 
of the computers is equipped. to act as a 
peripheral for the other, so communica- 
tion is impossible. In addition, electricity 
flows through the serial port, so the con- 
nection might damage the POKEY chip on 
one or both of the machines. 

It is possible, however, to connect 
two computers with a null modem cable, 
in order to transfer information from one 
computer to another. A null modem cable 
is essentially a normal modem cable with 
the send and receive lines reversed at one 
end. Information which one computer 
transmits on its send wire is received on 
the other's receive line, and vice versa. 

When linked with a null modem ca- 
ble, the computers would not share their 
memories, however. It would be more like 
calling a bulletin board to transfer files 
from one computer to another. In most 
cases it’s easier to use the disk drive or 
cassette recorder to transfer files. 

If you're running out of RAM, Atari 
and other manufacturers previously of- 
fered memory upgrades up to as much as 
48K. You still may be able to find one, 
However, it may make more sense to buy 
an Atari 65XE, which is software compati- 
ble with the 400 and features 64K of memo- 
ry and a full, typewriter-style keyboard. 





De Re Afari Lives 

I just read a letter in the February 1987 
installment of this column referring to 
the availability of the Atari reference 
book De Re Atari. Your readers may be 











interested to know that a large supply 
of these books is available for $10 per 
copy from this computer dealer. 


B & C Computervisions 
3283 Kifer Rd. 
Santa Clara, CA 95051 


They also stock many other hard-to- 
find Atari publications and products. 
M. J. White 


Thank you for this information. 





Atari Miscellany 
Ihave a few questions about Atari com- 
puters. What does the XIO statement 
do, and what is its syntax? How can I 
simulate the MOD function? How can I 
make cartridges for the Atari VCS video- 
game machine work on my computer? 
D. Botha 


The XIO statement is a general I/O (In- 
put/Output) statement. Atari BASIC al- 
ready has many I/O statements such as 
OPEN, CLOSE, GET, and PUT, but there 
are some tasks that you cannot do without 
XIO. For example, the following state- 
ment deletes a disk file named TEMP.BAS: 


XIO 33,#1,0,0,“D:TEMP.BAS” 


This can be done in program mode or 
direct mode. You can learn more about 
XIO in the Atari 400/800 BASIC Refer- 
ence Manual and similar sources. 

MOD is the remainder of an integer 
(whole number) division. Here is an ex- 
ample of how to translate the expression 
LOW = LOCATION MOD 256 into Atari 
BASIC: 

HI=INT(LOCATION/256) 
LOW=LOCATION — HI*256 


Finally, it is impossible to usefully 
connect VCS cartridges to your Atari com- 
puter. Although both devices have a 6502- 
based microprocessor, their video display 
hardware is totally incompatible. Rigging 
up the necessary hardware would proba- 
ble cost you more than the combined price 
of a VCS and a 65XE computer. 





Cassette Cacophony 
Whenever I save or print a document to 
tape in Atari SpeedScript 3.0, the com- 
puter makes an annoying hiss after the 
cassette operation has finished. When 
this happens in BASIC, I just type END 
to kill the sound. However, that’s not 
possible from SpeedScript, which runs 
as an AUTORUN.SYS file. I own an 
Atari 800XL. 





Sepehr Behram 


The Atari operating system does not prop- 
erly reset the sound channels when it 
finishes input/output operations. One so- 
lution would be to turn down the volume 
control on your TV or monitor, but that 
makes it impossible to hear the keyclicks 
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as you type. Here’s a simpler solution: 
When you hear the noise, turn off your 
printer and print to it. The hiss stops 
immediately, and SpeedScript displays 
the harmless error message Device not 
present. (Don’t forget to turn the printer 
back on.) This method takes advantage of 
the fact that the cassette drive and printer 
use the same Input/Output Control Block 
(OCB). 





Cleanest Atari INPUT 

This is in reference to your answer 
about cleaner Atari input in the October 
1986, “‘Readers’ Feedback.”’ Your an- 
swer is the normally accepted solution 
to the problem of performing an INPUT 
without printing a question mark. 
However, this line works even better: 


INPUT #16;A$ 


Besides being much shorter than 
what you suggested, this method elimi- 
nates the need to open and close files, 
and it reduces the risk of experiencing 
error 161 and other Input/Output Con- 
trol Block (IOCB) errors above 128. 

Chris Witham 


Thanks for the advice. 





Loading Touch Tablet 


Screens In Atari BASIC 

How can I write a BASIC program to 

display pictures drawn with the Touch 

Tablet and Atari Artist cartridge? 
Peter Hinz 


Loading Touch Tablet pictures in Atari 
BASIC is quite possible, and by calling an 
operating system routine, your BASIC 
program can load the images at machine 
language speed. But first, there are a few 
important points to cover. 

To begin with, the Atari Artist car- 
tridge that comes with the Touch Tablet 
saves pictures in a special compacted for- 
mat to conserve disk space. That's why, if 
you examine a disk directory of Atari 
Artist pictures, you'll notice that the files 
are usually of different lengths. Before you 
can load these pictures with a BASIC 
program, you have to convert them to 
uncompacted format. 

Although some people have written 
conversion utilities for this purpose, 
there's an even simpler method. It’s not 
mentioned anywhere in the Atari Artist 
manual, but if you hold down SHIFT and 
press the greater-than key (>), Atari Artist 
saves the current screen onto disk with the 
filename PICTURE. (Be aware that this 
replaces any existing file named PICTURE 
on the disk.) The file PICTURE is uncom- 
pacted and always takes up 62 disk sectors. 
This trick is useful in a couple of ways. It 
makes it possible to load Atari Artist pic- 
tures into other drawing programs for the 
Atari that use this format, including the 
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Atari Light Pen’s Atari Graphics cartridge 
and Datasoft's Micropainter. And it also 
makes it possible to load Atari Artist pic- 
tures into your own programs. 

But first, another point: Before load- 
ing the picture with a BASIC program, 
you have to set up the proper graphics 
mode. Atari Artist (and most other draw- 
ing programs for the Atari) uses a special 
mode often known as GRAPHICS 742. Of 
course, there’s really no such thing as 
GRAPHICS 7%, but the term refers to the 
fact that this mode has the same horizon- 
tal resolution as GRAPHICS 7 (160 pixels) 
and the same vertical resolution as 
GRAPHICS 8 (192 pixels, without a text 
window). Yet, it also offers the same num- 
ber of simultaneous screen colors as 
GRAPHICS 7 (four), while GRAPHICS 8 
is limited to only two colors. Because it 
combines the best of both modes, GRAPH- 
ICS 7% has been the most popular mode 
for drawing programs. 

GRAPHICS 7% has always been sup- 
ported by the Atari operating system. 
However, until the XL and XE series com- 
puters came out, it was not available from 
Atari BASIC without making some special 
POKEs to modify the display list. (The 
display list is an area of memory that tells 
the computer which graphics mode to dis- 
play on the screen.) On an XL or XE, 
GRAPHICS 7%, is called GRAPHICS 15. 

The following BASIC program shows 
how to load a 62-sector screen file named 
PICTURE at machine language speed. It 
should work with any uncompacted screen 
files, including those created with Atari 
Artist, the Atari Light Pen, and Micro- 
painter. This program is actually a slightly 
modified version of the program named 
MENU on the Atari COMPUTE! DISK. It's 
easily adapted to your own BASIC pro- 
grams. Briefly, here’s how it works. 

Lines 10 and 160 create a very short 
machine language routine that is used 
later to call a high-speed loading routine 
in the operating system. Lines 170-177 set 
up graphics mode 7%: on any Atari com- 
puter. If your program is intended only for 
XL and XE models, you can replace these 
lines with a single statement such as 170 
GRAPHICS 15+16. Line 190 opens the 
file PICTURE on disk and jumps to the 
subroutine at line 980. This subroutine, in 
turn, calls an operating system routine 
which loads the screen into memory at full 
speed. Line 200 simply loops endlessly so 
the picture stays on the screen. Press 
BREAK or SYSTEM RESET to end the 
program. 


10 DIM CIOS(7) 

160 ClO$=“hhh”:CIO$(4)= CHR$ 
(170) :CIO$(5)=“LV“:CIO$(7)= 
CHR$(228) 

170 GRAPHICS 8+16:DL=PEEK 
(560) +256*PEEK(561) +4 

175 POKE DL-1,14+64:FOR I=2 TO 
194:IF PEEK(DL+1)=15 THEN 
POKEDL+1,14 











176 IF PEEK(DL+1)=15+64 THEN 
POKE DL+1,14+64 
177 NEXT I 
190 OPEN #1,4,0,“D:PICTURE”: 
ADL=PEEK(88): 
ADH=PEEK(89):LN=7936:GO- 
SUB 980:CLOSE #1 
200 GOTO 200 
980 X=16:REM File#1,$20 
990 ICCOM=834:ICBADR= 
836:ICBLEN = 840:ICSTAT =835 
1000 POKE ICBADR+X,ADL:POKE 
ICBADR+X+1,ADH 
1010 L=LN:H=INT(L/256):L =L- 
H*256:POKE ICBLEN+X,L 
:POKE ICBLEN+X+1,H 
1020 POKE ICCOM+X,7:A=USR 
(ADR(CIO$),X) 
1025 RETURN 


When the picture appears, chances 
are the screen colors won't be right. You'll 
have to recreate the picture's original col- 
ors with four SETCOLOR statements in- 
serted somewhere between lines 170 and 
190. You can figure out what these SET- 
COLOR statements should be by looking 
at the Color Menu screen in Atari Artist. 
The four color register numbers along the 
bottom of the Color Menu screen—O, 1, 2, 
and 3—correspond to the first parameter 
in the SETCOLOR statement. Color 0 = 
SETCOLOR 4, color 1 = SETCOLOR 0, 
color 2 = SETCOLOR 1, and color 3 = 
SETCOLOR 2. The second parameter in 
SETCOLOR matches the color numbers 
along the vertical color bar on the Color 
Menu screen (0 to 15). And the third 
parameter in SETCOLOR is derived from 
the vertical luminance bar on the Color 
Menu screen (also 0 to 15, but use the even 
numbers only). For example, if color 0 in 
Atari Artist is set to black, your program 
would need a statement such as SET- 
COLOR 4,0,0. 

Incidentally, another undocumented 
trick makes it possible to load 
uncompacted-format pictures into Atari 
Artist, too. Simply hold down SHIFT and 
press the less-than key (<). This way, you 
can take 62-sector pictures created with 
the Atari Light Pen, Micropainter, and 
other drawing programs and modify them 
with the Touch Tablet. If you then save 
this screen with Atari Artist in the usual 
way, it’s converted to compacted format. 





Atari DOS 3.0 Vs. 2.5 
I have purchased an Atari 1050 disk 
drive with DOS 3.0. I recently heard 
that this DOS is no good, and that I 
should use DOS 2.0 or 2.5. What is so 
wrong with DOS 3.0, and why shouldn't 
L use it? Is DOS 2.5 the best one yet for 
the 1050, and where can I get it? 
Gary Cerasoli 
Before getting to your questions, let's 
briefly review the history of Atari disk 
operating systems: 
¢ DOS 1.0 was introduced with the 

















400/800 computers and 810 disk drive in 
1979. It was workable, but suffered from 
some bugs and unimplemented features. 
Also, the entire DOS was always resident 
in RAM (Random Access Memory). Al- 
though this was convenient—the DOS 
menu appeared instantly when you typed 
the DOS command—it consumed too 
much memory in a period when few peo- 
ple had more than 24K or 32K of RAM. 


¢ DOS 2.0, also known as 2.0S (single- 
density), replaced DOS 1.0 in late 
1980/early 1981. It fixed the bugs in DOS 
1.0, added significant new features, and 
conserved memory by keeping only part of 
itself in RAM. The disk-resident portion 
of DOS 2.0 loads into memory only when 
you type the DOS command. 

* DOS 3.0 was introduced with the dual- 
mode 1050 disk drive in 1983. The 1050 
works in the traditional Atari single- 
density mode (88K of storage per disk) as 
well as an enhanced-density mode (127K 
of storage per disk). DOS 3.0 was designed 
to support the enhanced-density mode 
and to be easier to use. But most Atari 
users found DOS 3.0 to be clumsy and 
inconvenient, especially when swapping 
disks with other people or when mixing 
single-density and enhanced-density 
disks. Although the 1050 drive automati- 
cally adjusts itself for either density, DOS 
3.0 disks and 2.0 disks are incompatible 
with each other. 

¢ To solve these problems, DOS 2.5 was 
introduced in 1985. This numbering 
scheme sometimes confuses people, since 
2.5 was released two years after 3.0, but 
2.5 is so named because it is closely relat- 
ed to DOS 2.0. In fact, the 2.5 menu is 
almost identical to the 2.0 menu, save for 
one additional option (Format Single). The 
advantage of 2.5 is that it works with both 
single- and enhanced-density disks on the 
1050 drive as well as single-density disks 
on the older 810 drives. This makes life 
easier for people who have both formats in 
their disk libraries and for those who swap 
disks with other users. 

DOS 2.5 is available free from most 
Atari dealers and user groups. It comes 
with utilities for converting 3.0 files to 
2.0/2.5 format, for customizing your copy 
of 2.5, and for automatically booting up a 
RAM disk on the 130XE computer. 





Reading The Atari Touch 
Tablet In BASIC 
I am currently working on an Atari 
program that lets me create high- 
resolution drawings in graphics mode 
15. However, the drawing should be 
done with the Atari Touch Tablet. How 
can a program read the Touch Tablet 
coordinates? 

Peter Hinz 


Reading coordinates from the Atari Touch 





Tablet is very easy in Atari BASIC. The 
Touch Tablet returns the same values as 
paddle controllers, and Atari BASIC con- 
tains a function called PADDLE for read- 
ing these controllers. Use PADDLE(0) to 
read the horizontal position of the stylus 
on the tablet, and PADDLE(1) to read the 
vertical position (assuming that the tablet 
is plugged into controller port 1). Both 
functions return values ranging from 1 to 
228. When nothing is touching the tablet 
surface, these functions return the value 
228. 

Reading the Touch Tablet buttons is 
just as easy. Use the PTRIG(0) function to 
read the left button, and PTRIG(1) to read 
the right button (again, assuming that the 
tablet is plugged into port 1). When a 
button is pressed, these functions return a 
value of 0. Otherwise, they return a value 
of 1. 

The button on the Touch Tablet's 
stylus works a little differently. To detect 
this button press, use the STICK(0) func- 
tion (normally intended for reading a joy- 
stick). If the stylus button is pressed, 
STICK(0) returns a value of 14. Otherwise, 
it returns the value 15. 

The following example program 
prints the tablet coordinates on the screen 
along with messages when any of the 
buttons are pressed: 


10 X=PADDLE(0):¥ =PADDLE(1) 

20 PRINT X,Y 

30 IF PTRIG(0)=0 THEN PRINT “LEFT 
BUTTON PRESSED” 

40 IF PTRIG(1)=0 THEN PRINT 
“RIGHT BUTTON PRESSED” 

50 IF STICK(0)=14 THEN PRINT 
“STYLUS BUTTON PRESSED” 

60 GOTO 10 





Atari Program Overlays 
I’m programming a trivia game on my 
Atari 800. I was wondering if I could 
use the ENTER’’D:” command to 
merge the questions for different cate- 
gories into the program. The questions 
are stored in additional program lines 
on disk, My problem is that I can’t get 
the main program to continue running 
after it enters the new question lines. Is 
there any way to keep the program 
running after it does an ENTER“D:” 
command? 

David Rivera 


Yes. In fact, there are several ways. What 
you're really asking is how to load over- 
lays—new program lines that merge into 
memory under program control. By loading 
overlays, a program can, in effect, “re- 
write” itself as it runs. This powerful tech- 
nique is useful for a wide variety of tasks. 

The simplest way to prepare an over- 
lay is to append an appropriate direct- 
mode command onto the file containing 
the new lines you want to load. This is 
most easily done with a word processor or 





text editor that handles ASCII files, since 
the new lines must be stored in ASCII 
format with the LIST command to work 
with ENTER, anyway. Almost all word 
processors for Atari computers handle 
ASCII text, including AtariWriter, 
PaperClip, The Writer's Tool, Text Wiz- 
ard, and COMPUTE!’s SpeedScript. 
Follow these steps: In BASIC, type in 
or load the program lines that you want to 
merge with the main program. Store the 
lines on disk or tape in ASCII format with 
the LIST command, not SAVE or CSAVE. 
Load the file into your word processor or 
text editor. Move to the end of the file and 
add whatever direct-mode command you 
want the computer to perform after EN- 
TER is executed. Typically, this command 
is either a GOTO to some other line in 
your program, or a RETURN if the overlay- 
loading routine is called with a GOSUB. 
You must type this command as a direct- 
mode statement without a line number. Be 
sure the command ends with a RETURN 
keypress. Then save the file back to disk or 
tape. The overlay is now complete. 
When your main program loads this 
overlay with ENTER, the new lines are 
merged into memory and become part of 
the main program. (Remember that the 
new lines will replace any existing lines 
that have the same line numbers.) After 
the computer loads the last program line 
of the overlay, it executes the direct-mode 
command you tacked on with the word 
processor. If you don't have a word pro- 
cessor, you can add the direct-mode com- 
mand by using OPEN with the append 
option—see your BASIC manual. 
Another method of loading overlays 
is to use the dynamic keyboard tech- 
nique. This involves printing one or more 
direct-mode commands on the screen, po- 
sitioning the cursor over the commands, 
and then activating the Atari's forced- 
read mode by POKEing 13 into memory 
location 842. To see an example, LIST 
these lines to disk or tape as your overlay 
(use the filename OVERLAY.LST for disk): 


100 PRINT “NEW LINE 100...” 
200 PRINT “NEW LINE 200...” 
300 PRINT “NEW LINE 300...” 
400 PRINT “NEW LINE 400...” 
500 PRINT “NEW LINE 500...” 


Type NEW, then enter these lines as the 
main program (replace the D: in line 30 
with C: if you're using cassette): 


10 GRAPHICS 0 

20 POSITION 2,4 

30 PRINT “ENTER”;CHR§(34);“D: 
OVERLAY.LST” 

40 POSITION 2,7 

50 PRINT “CONT” 

60 POSITION 2,0 

70 POKE 842,13 

80 STOP 

90 POKE 842,12 

99 PRINT “PROGRAM CONTINUES 
HERE” 
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When you type RUN, you'll see the 
main program load the overlay and con- 


tinue running. In effect, the POKE in line 
70 makes the computer press its own RE- 
TURN key over the commands printed on 
the screen. The POKE in line 90 turns off 
this mode so the program can continue 
normally. If you want to blank the screen 
for cosmetic purposes while this program 
is working, add these lines: 


25 POKE 559,0 
95 GRAPHICS 0 


By experimenting, you can add this 
routine to your own programs. The dy- 
namic keyboard technique can execute 
virtually any command under program 
control in this manner. 


128 Atari Colors 

Here is a machine language program 

that allows your Atari computer to dis- 

play 128 colors at the same time. The 
program displays a different color on 
each horizontal display line. 

10 FOR I=0 TO 21:READ A:POKE 
1536+1,A:NEXT I 

20 POKE 752,1:PRINT CHR$(125):A= 
USR(1536) 

30 DATA 173,11,212,201,32,208,249, 
141,10,212,142,24,208,232,232,208, 
246,142 

40 DATA 24,208,240,232 


David Boyer 


Thank you for the example. 


HELP For Atari XL And XE 

I have an Atari 800XL and would like to 

know how to read the HELP key. 
R.E. Brock 


The status of the HELP key can be deter- 
mined by PEEKing location 732 on the 
Atari XL and XE computers. If the HELP 
key alone is pressed, this location returns 
a value of 17; when SHIFT and HELP are 
pressed simultaneously, it contains 81. 
Pressing CONTROL and HELP returns a 
value of 145. The statement POKE 732,0 
clears location 732, so you can check for 
subsequent keypresses. 


Sc 











Atari 
Character 
Codes 


Bill Wi 


This discussion of Atari character 
codes is reprinted from Wilkinson's 
INSIGHT: Atari column in the March, 
1986, issue of COMPUTE!. 


Last month’s discussion about 
where and how to place things in 
memory served as a good lead-in to 
this month’s topic: character codes. 
If you've read the heftier reference 
material, including COMPUTE! 
Book’s Mapping the Atari, you may 
have discovered that your eight-bit 
Atari computer actually uses three 
different types of codes to represent 
the various characters (letters, 
numbers, punctuation, graphics 
symbols) it works with. All of these 
codes assign a unique number to 
represent each character, but the 
three codes are incompatible with 
each other because they use differ- 
ent numbering schemes. 

The most commonly encoun- 
tered code is called ATASCII, which 
stands for ATari-version American 
Standard Code for Information In- 
terchange. Except for the so-called 
control characters—such as carriage 
return, tab, and so on—ATASCII is 
compatible with standard ASCII. 
(Why Atari chose to modify the 
standard is anyone’s guess.) ATAS- 
CII is the character code used by 
PRINT, INPUT, CHR$(), ASC(), 
and most external devices such as 
printers and modems. 


kinson 


For example, in ATASCII (and 
ASCII), the code for uppercase A is 
65. You can verify this in BASIC: 


PRINT CHR$(65) 


or 
PRINT ASC(“A”) 


Virtually every Atari BASIC 
book (even Atari’s own) shows the 
character represented by each 
ATASCII code. You can also run 
Program 1 below to display each 
character and its code. (Press CTRL-1 
to pause and continue the display.) 


Screen Codes 

The second character code found in 
your Atari is the keyboard code. The 
keyboard code for any character is 
actually the value read from a hard- 
ware register in memory when the 
key for that character on the key- 
board is pressed, Program 2 below 
lets you find the keyboard code for 
any character. Just for fun, try some 
of the keys or key combinations 
which don’t normally produce 
characters, such as CTRL-SHIFT- 
CAPS, Neat, huh? 

Finally: screen codes. This term 
refers to the byte value you must 
store in memory to display the de- 
sired character on the screen. 
“What?” you ask, “How do those 
differ from the ATASCII codes?’ 
After all, to put the string BANANA 
PICKLE PUDDING on the screen, 
all it takes is a simple BASIC 
statement: 
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PRINT “BANANA PICKLE PUDDING” 


And besides, aren’t the charac- 
ters in quotes supposed to be ATAS- 
CII codes? Good questions. Now for 
some complicated answers. 

Actually, if the original Atari 
designers had thought just a little 
harder and added just a few more 
logic gates to the thousands already 
in the ANTIC and GTIA chips, 
ATASCII and screen codes could 
have been one and the same. It’s 
similar to the mistake of making 
ATASCI incompatible with ASCII. 
Sigh. But we’re stuck with what 
we've got, so let's figure out how it 
works. 

For starters, consider GRAPH- 
ICS 1 and GRAPHICS 2, the large- 
size character modes, You may 
have noticed that in either of these 
modes you can display only 64 dif- 
ferent characters on the screen. 
Now, if you recall last month’s 
demo programs, note that we can 
specify the base address of the char- 
acter set. That is, we can tell ANTIC 
where the character set starts by 
changing the contents of memory 
location 756 (which is actually a 
shadow register of the hardware lo- 
cation which does the work—see 
Mapping the Atari for more on this). 

In a sense, the ANTIC chip is 
fairly simplistic. When it finds a 
byte in memory which is supposed 
to represent a character on the 
screen, it simply adds the value of 
that byte (multiplied times eight, 
because there are eight bytes in the 
displayable form of a character) to 
the character set base address. This 
points to the memory address for 
that particular character. Ex- 
cept...well, let’s get to that in a 
moment. 


Exception To The Rule 
Because we want GRAPHICS 1 and 
2 (with their limited sets of 64 differ- 
ent characters) to display numbers 
and uppercase letters (omitting low- 
ercase letters and graphics), for 
these two modes it makes sense that 
the character set starts with the dot 
representation of the space character 
and ends with the underline—codes 
32 through 95, respectively. 

But why are these 64 charac- 
ters the only ones available in 
GRAPHICS 1 or 2? Because the up- 
per two bits of a screen byte in these 
modes are interpreted as color 








information, not as part of the char- 
acter (see the modification to Pro- 


gram 3 below). So only the lower 


six bits choose a character from the 
character set. Six bits can represent 
only 64 possible combinations, 
which is why these modes can dis- 
play only 64 characters. Bit pattern 
000000 becomes a space, 100101 is 
an E, and 111111 becomes an un- 
derline, and so on. 

When you use GRAPHICS 0 
(normal text), however, there is a 
strange side effect. In this mode, 
only the single upper bit is the color 
bit (actually, it’s the inverse video 
bit). This leaves 7 bits to represent a 
character, so we can have values 
from 0 to 127 decimal (0000000 to 
1111111 binary, $00 to $7F hex). 
Again, this value—after being mul- 
tiplied by eight—is added to the 
value of the character set base ad- 
dress. But which numbers in that 0 
to 127 range represent which 
characters? 

Well, we already know what 
the first 64 characters are—since 
the Atari’s hardware limitations 
dictate that they must be the same 
as in modes 1 and 2. So the next 64 
are the other characters. Program 3 
illustrates how the ATASCII char- 
acter set is linked to the screen set. 
Note how all the characters are pre- 
sented twice, once in screen code 
(ie, character ROM) order and 
once in ATASCII order. For some 
additional fun and info on modes 1 
and 2, change line 10 to GRAPH- 
ICS 1, (Do not change it to GRAPH- 
ICS 2 unless you put a STOP in line 
65 after the first FOR-NEXT loop.) 
Do you see what I mean about the 
upper two bits being color 
information? 

Now you know why there are 
three different character codes used 
in your computer. How can you 
take advantage of this information? 
Well, if you combine this knowl- 
edge with the programs I presented 
last month, you could invent your 
own character set and design a 
word processor for some foreign 
language. (If you come up with a 
good Cyrillic character set, let me 
know.) 

Actually, if you own an XL or 
XE machine, you have a second 
character set already built in. Just 
add this line to Program 3: 


20 POKE 756,204 








This tells the operating system 
and ANTIC that the base of the 
character set is at $CCO0, which is 
where the international character 
set resides. Someday you might 
find some use for these characters. 
How will you know until you try? 


Program 1: ATASCII Codes 


10 GRAPHICS 0 

20 FOR I=0 TO 255:PRINT I, 

30 IF I=155 THEN PRINT “[RETURN]” 
:GOTO 50 

40 PRINT CHRS$(27);CHR$(I) 

50 NEXT I 

60 REM USE CONTROL-1 TO PAUSE 


Program 2: Keyboard Codes 


10 DIM 

HEX$(16): HEX$=“0123456789A BCDEF” 

20 POKE 764,255 

30 KEYCODE=PEEK(764) 

40 IF KEYCODE=255 THEN 30 

50 HI=INT(KEYCODE/16):LOW =KEY- 
CODE-16*HI 

60 PRINT “KEYCODE: HEX $”; 

70 PRINT HEX$(HI+1,HI+1);HEX$(LOW 
+1,LOW +1); 

80 PRINT “, DECIMAL “;KEYCODE 

90 GOTO 20 


Program 3: Screen Codes 


10 GRAPHICS 0 

30 SCREEN = PEEK(88) + 256*PEEK(89) 

40 REM FIRST: SCREEN CODE ORDER 

50 FOR C=0 TO 255:POKE 

SCREEN+C,C 

60 NEXT C 

70 REM THEN: ATASCII ORDER 

80 SCR2=SCREEN+40*8 

90 FOR C=0 TO 255:CHAR=C 

100 IF C>127 THEN CHAR=C-127 

110 IF CHAR<32 THEN CHAR=C 
+64:GOTO 140 

120 IF CHAR>95 THEN CHAR=C 
:GOTO 140 

130 CHAR=C-32 

140 POKE SCR2+C,CHAR 

150 NEXT C 

999 GOTO 999:REM WAIT FOR BREAK 
KEY 

cS 
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This discussion of Atari character 
codes is reprinted from Wilkinson's 
INSIGHT: Atari columns which 
appeared in the in the August and 
September, 1985, issues of COMPUTE). 


Much of what I’m about to discuss 
this month has appeared in this 
column before. And the bulk of this 
information can also be found in 
the Atari Technical Reference Man- 
ual—presuming you can read 
“techlish.” But this intro is neces- 
sary before we get into the meat of 
our subject. 

Still with me? Let’s go. Atari’s 
operating system (OS)—which, 
like the OS in any eight-bit com- 
puter, takes up the bulk of Read 
Only Memory (ROM)—is really a 
thing of beauty. In fact, it may be 
the only consistent OS to be found 
in any microcomputer, short of 
those sporting UNIX or its deriva- 
tives. CP/M and MS-DOS are such 
kludges that most commercial pro- 
grams bypass the OS. (That’s why 
there are so many “almost PC-com- 
patibles.”) The Commodore 64’s 
operating system comes close, but 
its disk input/output is difficult at 
best. And Apple’s ProDOS manual 
states that “users desiring to per- 
form I/O to devices other than the 
disk drive are on their own!” 

Atari users, on the other hand, 
enjoy a system with such complete 
support that, for most programs, all 
necessary input/output operations 
can be executed by calling a single 
subroutine! That subroutine is 
called, appropriately, Central Input / 
Output (CIO). By calling CIO with 
the proper values in certain memo- 
ry locations and the proper pointer 
in the 6502’s X register, your pro- 
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grams can perform such diverse op- 


erations as formatting a disk, 


drawing a line on the graphics 
screen, fetching a keystroke from 
the keyboard, sending output to the 
printer, or reading 25,000 bytes 
from a disk file. 

Yet, CIO is invisible to most 
Atari users. For example, many of 
the capabilities which magazine 
and newsletter articles attribute to 
BASIC are not part of BASIC at all. 
None of the graphics (including the 
so-called BASIC graphics modes) in 
Atari BASIC are actually performed 
by BASIC. Instead, BASIC simply 
translates the graphics command 
into a call to CIO. Atari developed 
this system in 1978, and it wasn’t 
until the Macintosh appeared that 
such a revolutionary concept was 
repeated in a popular computer. 

Generally, you have to become 
a machine language programmer to 
appreciate and use all the features 
of CIO. So why read any of this, 
then? Because calls to CIO can’t 
perform every input/output task 
possible on Atari computers. What 
can’t CIO do? First, let’s take a 
glance at what it can do. 


Calling ClO 

When CIO is called by a program, it 
expects the X register to contain a 
pointer to an Input/Output Control 
Block (IOCB). IOCBs are blocks of 
memory 16 bytes long which con- 
trol CIO functions. The pointer val- 
ue for the X register is easily 
calculated—it’s actually the BASIC 
file number (as in OPEN #1,4, 
0,’K:) multiplied times 16, be- 
cause there are 16 bytes per IOCB. 
One of the bytes within the IOCB 
then tells CIO what function the 
program is requesting. 











Atari Input/Output 


There are seven fundamental 
functions available: OPEN, 
CLOSE, STATUS, PRINT, INPUT, 
Block PUT, and Block GET. In addi- 
tion, there are some extended func- 
tions. BASIC programmers are 
familiar with these because of the 
XIO statement, which allows you to 
call the functions from BASIC, But 
several other BASIC statements (in- 
cluding NOTE, POINT, DRAWTO, 
and LOCATE) access the CIO ex- 
tended functions, too. 

After CIO examines the IOCB 
and determines which function is 
being requested, it decides which 
device (keyboard, disk, screen, etc.) 
should service the request. Then it 
calls an appropriate routine within 
the device driver for that device. 
(For example, the Disk Operating 
System—or more properly, the File 
Management System—is the de- 
vice driver for the disk drive.) If the 
request is for an extended function, 
it is passed on unchanged to the 
device driver. 

Well, with 256 possible com- 
mand values, you would think that 
there isn’t any request, however bi- 
zarre, which couldn't be serviced 
via CIO. In theory, true. In reality, 
you have to stop adding functions 
somewhere or you run out of mem- 
ory. Thus Atari’s CIO-based graph- 
ics have no function for drawing a 
circle, and DOS provides no com- 
mand to format a disk without also 
writing a boot and directory. 

If you want to draw a circle, 
you can write a routine to calculate 
and PLOT points or change screen 
memory directly. If you want to 
mess with the disk drive, though, 
you have to learn about another 
routine within the Atari ROMs, Se- 
rial Input/Output. 
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The Mysterious SIO 
SIO—which lets Atari computers 
talk to devices (such as printers and 
disk drives) which hook up to the 
serial bus—has acquired an unde- 
served aura of mystery. Actually, 
though, in some ways it is easier to 
call SIO than it is to call CIO! 
For example, there is only one 
SIO “device” and only one Device 
Control Block (DCB). So even the X 
register pointer required by CIO 
isn’t necessary when calling SIO. 
Intrigued? Read on. We'll show 
how to write a program to call SIO. 


Using Serial Input/Output 

I have just introduced the structure 
of Atari's operating system (OS). 
My most important point is that the 
OS consists of several layers. When 
you type in a BASIC statement such 
as LPRINT “Hi There!’’, you cause 
a fairly complex chain of events. 
First, BASIC figures out that 
LPRINT means you want to use a 
printer, so it calls the OS to open a 
channel to the printer (always 
channel number 7, in this case). 
Then BASIC sends the bytes to be 
printed to a part of the OS called 
Central Input/Output (CIO), which 
in turn realizes that a file to the 
printer has been opened on that 
channel. CIO calls the printer driv- 
er, which collects bytes until it has a 
block of them (or until it gets a 
carriage-return character or a 
CLOSE command). Finally, the 
printer driver sends a block of bytes 
to the printer by calling Serial Input/ 
Output (SIO)—another subroutine 
inside the OS, and our next subject 
of discussion. 

I'd like to point out that this 
process stops at SIO only as far as 
the computer is concerned. The 
printer interface (for example, an 
850 Interface Module) also contains 
a microprocessor which collects the 
block sent to it by SIO. Then the 
interface passes the block, a byte at 
a time, to the printer. Within the 
printer, yet another microprocessor 
is usually employed to control the 
various motors and hammers and 
wheels that actually place the char- 
acters on paper. 

Did you note that the process 
of printing even a single character 
most probably requires the use of 
three microprocessors? Did you 
stop to think that each of these 
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Location Name Size Purpose 
Hex Dec 
300 768 DDEVIC 1 Name of device on SIO bus (all disk drives use “1,” 
$31, as a name). 
301 769 DUNIT 1 Unit number of device (to distinguish D1: from D2:, 
for example). 
302. 770 DCOMND 1 Command, usually an ATASCII letter, such as “’R” for 
read sector (but ‘’!”’ will format a disk!). 
303. 771 DSTATS 1 Direction control before call to SIO; status of operation 
upon return, 
304 772 DBUF 2 Address of buffer to read from or write to, as 
appropriate. 
306 774 DTIME 2 Timeout value. SIO waits this many seconds before 
giving up. 
308 776 DBYTE 2 Number of bytes to transfer (always 128 or 256 for 
disks). 
30A 778 DAUX 2 Purpose varies; always sector number when used with 
disks. | 
The way your Atari computer ; processors requires software to 
“talks” to your interface module, | make it work? Did you ever wonder 
though, is strictly an Atari inven- | why there are so many people mak- 
tion—the SIO. There is a well- | ing a living at programming? 
defined protocol associated with | (Though barely, in the case of some 
SIO. It includes such niceties as | of us.) 
Command and Data Frames, Ac- Perhaps the most amazing 
knowledgment, Nonacknowledg- | thing is that, for the most part, the 
ment, Command and Bus Errors, | three microprocessors work reliably 
and more. Luckily, 99 percent of all | and efficiently together. (It is even 
Atari programmers need never | more amazing when you consider 
learn these gory details, since there | that either the printer or interface 
really isn’t anything you can do to | module is often made by a compa- 
change their workings. ny other than the one which made 
the computer!) The secret to success 
Disk Access Via SIO here is standardization. The usual 
Some programmers, however, do | printer connection is a fairly simple 
want to send and receive blocks via | one, originally defined by a compa- 
SIO. And usually the blocks to be | ny named Centronics and now 
transferred are disk sectors. So let’s | adopted by almost every manufac- 
look at how one reads or writes a | turer in the microcomputer market. 
Note: The following example programs do not appear on the disk that 
accompanies this magazine. 
Program 1: SIO Subroutine 
9000 REM 
9010 REM disk sector i/o routine 
9020 REM . ENTER: 
9030 REM. sector number in SECTOR 
9040 REM. drive number in DRIVE 
9050 REM. buffer address in ADDR 
9060 REM. command in CMD$ 
9070 REM. density in DENSITY 
9080 REM (only “R”, “W”, “P” are valid for CMD$) 
9090 REM (only 1=SGL and 2=DBL are valid for DENSITY) 
9100 REM . EXIT: 
9110 REM. status in SIOSTATUS 
9120 REM 
9160 TRAP 9220:REM activated if SIOCALL$ already DIM’d 
9170 DIM SIOCALL$(16) 
9180 RESTORE 9210 
9190 FOR CNT=1 TO 14:READ BYTE 
9200 SIOCALL$(CNT)=CHRS(BYTE):NEXT CNT 
9210 DATA 104,32,89,228,173,3,3,133,212,169,0,133,213,96 
9220 TRAP 40000:REM turn off TRAP 
9230 POKE 768,ASC("1”):REM don’t ask me why 
9240 POKE 769, DRIVE:REM must be 1 through 8 
9250 POKE 770,ASC(CMD$) 
9260 POKE 771,128:REM assume write 
eS 
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specific disk sector. 
When SIO is called by a pro- 
gram, it expects to find certain 


information in a Device Control 
Block (DCB). There is only one 
DCB, located at $0300-$030B 
(768-779 decimal). It contains four 
one-byte values and four two-byte 
(word) values, all of which must be 
set up properly. The accompanying 
table briefly describes each location 
in the DCB. See COMPUTE! Books’ 
Mapping the Atari for more details. 

Does all this look confusing? 
Not to worry. Program 1 below is a 
subroutine which does most of the 
work for you. Just type it in, LIST it 
to disk or cassette, and use it in your 
own programs whenever you wish. 
Program 2 demonstrates how to use 
the subroutine, though I hope the 
comments make it pretty much self- 
explanatory. (Perhaps I should note 
that a command of R reads a sector, 
P writes a sector without verifying 
it, and W both writes and verifies a 
sector.) To use Program 2, you must 
add the subroutine from Program 1. 
You can either type in the lines 
from Program 1, or ENTER them 
from disk or tape if you have LIST- 
ed out a copy of Program 1, Pro- 
gram 3 is the source code behind 
the DATA statements in line 9210 
of Program 1. 

If you type in and use Program 
2, you might like to remember that 
the volume table of contents (VTOC) 
of a DOS 2.0-compatible disk is in 
sector 360. The directory occupies 
sectors 361 to 368. Sectors 1, 2, and 
3 are for booting only. All other 
sectors from 4 to 719 should be 
DOS file sectors. (See COMPUTE! 
Books’ Inside Atari DOS for more 
info. Caution: The diagram of the 
sector link bytes is wrong.) 

Finally, I give you a hint and 
challenge: Most drives not made by 
Atari allow the user to specify their 
configuration (for example, single 
or double density). You can read 
their configuration blocks with an 
SIO command of N (or write via O). 
But be careful! DSIZE must be given 
as 12 bytes. Can you modify our 
subroutine to read the configura- 
tion block? Good luck. 








9270 POKE if CMD$="R” THEN POKE 771,64 

9280 POKE 773,INT(ADDR/256):REM buffer address 
9290 POKE 772,addr—256*peek(773) 

9300 POKE 774,3:REM short timeout 

9310 POKE 775,0:REM (high byte of timeout) 

9320 POKE 776,128:POKE 777,0:REM assume single density 
9330 IF DENSITY = 2 THEN POKE 776,0:777,1 

9340 POKE 779,INT(SECTOR/256) 

9350 POKE 778,SECTOR — 256* PEEK(779) 

9360 SIOSTATUS =USR(ADR(SIOCALLS)) 

9370 RETURN 


Program 2: SIO Demo 


1000 REM PROGRAM TO DEMONSTRATE SECTOR READ SUBROUTINE 
1010 REM NOTE: rather than ask questions, we 


1020 REM . assume that we will work with drive 
1030 REM . number 1 and that it is single 

1040 REM. density (128 byte sectors) 

1050 REM 


1100 DIM BUFFER$(256):REM guaranteed adequate 

1110 ADDR=ADR(BUFFER$):REM required by subroutine 
1120 DRIVE=1:REM assumption...easily changed 

1130 DENSITY =1:REM assumption...ditto 

1140 DIM CMD§(1):CMD$="R”:REM always, for this demo 
1150 REM 

1160 PRINT “What sector to display”; 

1170 INPUT SECTOR 

1180 GOSUB 9000 

1190 GRAPHICS 0 

1200 PRINT “Read Sector ";SECTOR;” gave Status ";SIOSTATUS 
1210 SIZE=DENSITY*128:REM size is 128 or 256 

1220 SECTOR=PEEK(ADDR+SIZE—3) 

1230 FILE=INT(SECTOR/4) 

1240 SECTOR=SECTOR—4*FILE 

1250 SECTOR=SECTOR*256+PEEK(ADDR+SIZE—2) 

1260 CNT = PEEK(ADDR+SIZE~1) 

1270 PRINT “If DOS file sector, this is file #”;FILE 


1280 PRINT” there are ";CNT;” bytes in this sector” 
1290 PRINT” and the next sector is number “;SECTOR 
1300 PRINT 


1310 FOR LINE=0 TO DENSITY*128—1 STEP 8 

1320 BYTE=LINE:GOSUB 1500:PRINT ”:”; 

1330 FOR CNT=0 TO 7 

1340 BYTE=PEEK(ADDR+LINE+CNT):GOSUB 1500;:PRINT ” ”; 
1350 NEXT CNT 

1360 FOR CNT=0 TO 7 

1370 BYTE=PEEK(ADDR+LINE+CNT) 

1380 IF BYTE>127 THEN BYTE=BYTE—128 

1390 PRINT CHR$(27);CHRS(BYTE); 

1400 NEXT CNT 

1410 PRINT 

1420 NEXT LINE 

1430 PRINT 

1440 GOTO 1160 

1450 REM 
1460 REM A QUICKY DECIMAL TO HEX CONVERTER 

1500 TRAP 1520 

1510 DIM HX$(16):HX$="0123456789A BCDEF” 

1520 TRAP 40000 

1530 HX=INT(BYTE/16)+1:PRINT HX$(HX,HX);:HX = BYTE —16*HX+17:PRINT 
HX$(HX,HX); 

1540 RETURN 


Program 3: Subroutine Source Code 


Note: This listing is provided for informational purposes; it requires an 
assembler to enter into your computer. 





*= anyplace 


CALLSIO 
PLA throw away count of arguments 
JSR SIOV iat $E459) 
LDA DSTATS _ ;SIO status (from DCB) 
STA FRO ;floating point register 0, $D4 
LDA #0 
STA FRO+1 ;(to get a two-byte value) 
RTS back to BASIC caller € 
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This is another one of those “Did 
you know?” tidbits. Did you know 
that when you use GRAPHICS 0 
from Atari BASIC you have auto- 
matically opened the screen for 
GETting and PUTting via file num- 
ber 6? It’s true, and it is because 
Atari BASIC does not check the 
mode number for the GRAPHICS 
statement. 

GRAPHICS 0 is thus exactly 
equivalent to: 


OPEN #6,12+16,0,”S:” 


So if you need to GET or PUT from 
or to the screen, you can do it direct- 
ly to file #6 without any further ado. 

Unfortunately, there are a few 
gotchas involved in using GET and 
PUT to the Atari Screen graphics 
driver (“S:”), some of which you 
may have seen before, so let’s discuss 
them, as well as ways around them. 

The first problem is that if you 
use PUT #6 combined with POSI- 
TION statements or PRINT state- 
ments, you will probably end up 
leaving some inverse video spaces 
(white boxes) around on the screen, 
as Program 1 illustrates. This is be- 
cause the screen graphics driver 
works almost (but not quite) like 
the screen editor driver (‘E;”, the 
normal channel #0 device which 
PRINT and INPUT use). Unfortu- 
nately, ““S:” can’t seem to handle its 
cursor properly, so it may be best to 
avoid using PUT #6. 


Problems With PUT #6 


10 GRAPHICS 0 

20 POSITION 30*RND(0),20*RND(0) 
30 PUT #6,65+20*RND(0) 

40 GOTO 20 


How can we avoid PUT #6 if 
we have something we need on the 
screen? Simple. Use PUT#0 (if you 
have BASIC XL or any other prod- 
uct which allows PUT to file #0) or 
PRINT. If you use PRINT, of 
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course, you will have to use: 
PRINT CHR$(X); 


in place of PUT #0,X. And why does 
outputting to file #0 work where 
using #6 does not? Because #0 is 
opened to “E:”, and there are sever- 
al subtle differences between “E:” 
and “S:” where cursor positioning 
and character I/O are concerned. 

Unfortunately, while the prob- 
lems with PUT #6 are fairly easy to 
get around, the problems with GET 
#6 must be dealt with directly. And 
why can’t we simply use GET #0 in 
place of #6 here, as we did with 
PUT? Because, when you ask ‘’E:” 
(channel #0) for a character, it waits 
until the user actually types in an 
entire line—terminated by a RE- 
TURN character—before returning 
anything at all to its caller (you are 
the caller via BASIC in this case). 

The whole reason for using GET 
#6 is to allow ourselves to read indi- 
vidual characters from the screen. 
We simply can’t use GET #0 or any- 
thing else which accesses “E:”. 

But this is putting the cart 
before the horse a little. Before “’fix- 
ing” the problem, let's illustrate it 
with Program 2. 


Problems With GET #6 


10 GRAPHICS 0 

20 PRINT “ABCDEFGHIJKLMNOP” 

30 FOR I=2 TO 12:POSITION [1,0 

40 GET #6,CHAR 

50 POSITION 20,20: PRINT CHAR 

60 FOR J=1 TO 200: NEXT J: REM just a 
delay loop 

70 NEXT I 


I hope you actually stopped 
while reading to try out that listing. 
Bizarre, isn’t it? It seems that you 
can’t GET data from the screen 
without destroying it. Now, most of 
the articles which I have seen which 
note this problem suggest that the 
only safe fix is the following: 





PUT And GET 
And The Text Screen 


1. POSITION yourself on the char- 
acter you want. 


2. GET the character to a variable. 

3. POSITION yourself again to the 
same location. 

4, PRINT the character back onto 
the screen. 


That fix will indeed work, but I 
would propose that an alternate so- 
lution is to simply print a “left ar- 
row” (backspace) and then the 
character, thus avoiding the extra 
POSITION statement. In Program 
2, we could simply add this line to 
fix things up: 

45 PRINT CHR$(30);CHRS$(CHAR); 


Now that you know how to 
properly PUT and GET to the 
screen, you probably have a fair 
idea of how I built my onscreen 
editor. It isn’t too hard to do any- 
thing you want to the GRAPHICS 0 
screen, once you get past the quirks 
in the Atari OS. 


Fettering Your NEXT 
Probably every BASIC book you 
have ever seen tells you to properly 
nest FOR/NEXT loops. Aside from 
the neatness of it, there are some 
good and practical reasons. Consid- 
er Program 3. 


Obviously Invalid Nesting 


10 FOR I=1 TO 6 
20 FORJ=1TO3 
30 NEXT I 

40 NEXT J 


Very few of you would deliber- 
ately write a BASIC program which 
looked like that. Even with the in- 
dentation I have given it, it should 
be obvious that something is wrong. 

And, yet, it is fairly easy to 
write a program which will look 
proper and yet have the effect of 
that listing! Don’t believe it? Try 
Program 4. 
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A Subtle Problem 


100 REM Program task: Print all num- 
bers, from 1 to 9, in a nested loop 
fashion. When the first sum of 15 or 

101 REM greater is found, cease the 
operation. When the sum is 10 or 
more, don’t print the result. 

102 REM Repeat for the products of the 
same numbers in the same fashion. 

110 PRINT "1”,’J”,“SUM” 

120 FOR I=1 to 9 


130 FOR J=1to9 
140 =SUM =I+J 
150 IF SUM > 14 THEN 200 


160 IF SUM> 10 THEN 190 
170 +‘ PRINT I,J,SUM 

180 NEXTJ 

190 NEXT I 

200 PRINT "I’,"J’,"PRODUCT” 
210 FOR I=1 TO 9 

220 FORJ=1TO9 

230 PROD =I*J 

240 ‘IF PROD > 14 THEN 290 
250 IF PROD > 10 THEN 280 
260 PRINT J,],PROD 

270 NEXTI 

280 NEXT J 

290 END 


Now this looks perfectly harm- 
less, if somewhat pointless, right? It 
looks like it should work fine. Yet, if 
you will type it in and RUN it, you 
will find that line 280 will give you 
a NEXT WITHOUT MATCHING 
FOR error the first time it is 
reached. How? Surely line 210 is 
the FOR which matches the NEXT 
of line 280. 


The Interpreter’s Dilemma 
If Atari BASIC were a compiler lan- 
guage, it would probably execute 
that program correctly. However, 
since it is an interpreter, it must 
work within the strictures of that 
mode, Interpreters, by their very 
nature, cannot easily keep a history 
of all NEXT usages. It is enough 
that they remember where the FOR 
statements are, so that when a 
NEXT is encountered they can go 
back to the FOR to execute the loop 
another time. 

Consider, then, the dilemma of 
the poor interpreter in the above 
program. In line 160, we are asking 
it to bypass the end of the inner 
FOR loop (since we know we are 
done with the previous usage of it) 
and start the next iteration of the 
outer loop (NEXT I). But wait. 
There is still a FOR J on the runtime 
stack, yet we are executing a NEXT 
I. What can we do? 

Atari BASIC does what most 
modern “smart” BASICs do. If it 
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does not match the last FOR on the 
stack, it presumes that the user has 
jumped out of the inner loop (as 
indeed we have here) since that is a 
common occurrence. So BASIC 
looks backward in the stack for a 
matching FOR. Eureka! It finds the 
FOR I only one level down in the 
stack, without any intervening GO- 
SUBs, so its supposition seems con- 
firmed. All works well. 

However, look at line 150, 
wherein we jump out of all the 
loops. What have we left on the 
runtime stack now? Obviously, 
both a FOR I and a FOR J. Well, no 
real problem. After all, we know we 
jumped all the way out of the loop, 
don’t we? We don’t. Why not? Be- 
cause a BASIC interpreter must pre- 
sume that the BASIC programmer 
knows what he or she is doing. It is, 
unfortunately, perfectly legal to 
jump in and out of a loop in Atari 
BASIC. 

So what can BASIC think when 
it gets to line 210 but that it is 
starting the inner FOR loop over 
again? It leaves the FOR I in place 
(for all it knows, the next statement 
it encounters might be a NEXT 1) 
and adds a new FOR J. 

Disaster really strikes in line 
220. Poor BASIC is trying its best. 
Knowing that it is now uncommon 
for BASIC programmers to jump 
out of loops or to jump to the begin- 
ning of a loop to start it again, 
BASIC almost has to presume that 
the FOR I of line 220 is the begin- 
ning of a new outer loop. Besides, it 
already has a FOR I on its runtime 
stack. How can it allow another? 

Well, if this is the beginning of 
a new outer loop, better throw 
away the old outer loop and any of 
its inner loops. Say good-by to the 
old FOR I and FOR J; we're ready 
for another outer loop with a new 
FOR I. Right? 

Wrong. But BASIC doesn’t 
know about it while it stays in the 
FOR I loop, since it encounters no 
other FORs or NEXTs. In fact, the 
entire loop executes nicely with no 
problems, and the FOR is properly 
removed from the stack when the 
last value of I is reached. Did you 
notice that the stack is now empty? 

Where did this NEXT J come 
from? FOR J was an inner loop and 
was thrown away when the outer 
loop was restarted. 





The Fix In Atari BASIC 
Actually, Atari BASIC is not a cul- 
prit here. Virtually every BASIC 
will have this same problem unless 
it makes a pre-pass through the 
user’s program to detect possible 
inconsistencies (such as jumping 
out of nested loops). In point of fact, 
Atari BASIC is almost a good guy 
here. Recognizing that even with 
the best interpretation we could do, 
we could not prevent users from 
writing (or needing to write) struc- 
tures such as I have shown you, we 
designed a “fix” into Atari BASIC. 
The fix takes the form of the 
POP statement. POP simply re- 
moves the last level of the runtime 
stack. In Program 4, the easiest fix is: 


150 IF SUM > 9 THEN POP:POP:GOTO 
200 


(and a similar fix is needed in line 
240, of course). 

Notice I said that was the easi- 
est fix. POP is usually not the best 
fix. Generally, you can write good 
and properly structured programs, 
with properly terminating FOR 
loops, without ever resorting to 
such extreme measures as the POP 
statement. Still, it is comforting to 
know that POP is around. Person- 
ally, I tend to use it whenever an 
error condition occurs and I want to 
get all the way back out to (for 
example) the menu level without 
leaving nasty GOSUBs for FORs on 
the runtime stack. 

A curiosity: Did you notice that 
if the nesting in lines 200 through 
290 is reversed (that is, if the FOR I 
occurs before the FOR J), the pro- 
gram will work correctly? Do you 
see why? Fundamentally, because 
you are now doing what BASIC 
expected you to do. Go try this 
example both ways on a Commo- 
dore or Radio Shack or whatever 
computer. 

If you ever get a NEXT WITH- 
OUT MATCHING FOR error, look 
for this kind of structure in your 
program. If you find it, you can fix it 
with POP, but wouldn’t it be nicer 
to write the program correctly? 

A footnote to all of that: Can 
you begin to get an appreciation of 
what language designers must con- 
tend with? It is not enough that a 
language do what it is expected to 
do. A good language will come 
halfway toward helping its users 
over the rough spots. 
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Benchmarks 


This discussion of benchmarks is re- 
printed from Wilkinson's INSIGHT: 
Atari column in the February, 1985, 
issue of COMPUTE!. 


Several readers have asked me why 
Atari BASIC compares so unfavor- 
ably to other computers on certain 
benchmarks. The two most com- 
monly mentioned are the BYTE 
magazine benchmarks and the Cre- 
ative Computing benchmark invent- 
ed by David Ahl. Stan Smith, of Los 
Angeles, asked some very pointed 
questions, which I will try to an- 
swer here. 

The BYTE benchmark is repro- 
duced below in Atari BASIC. It is the 
often-mentioned “Sieve of Erastoth- 
enes,” a program which produces 
(and counts) prime numbers. Its pri- 
mary advantage as a benchmark is 
that it can be implemented in virtu- 
ally any language (although only 
with much difficulty when using 
Logo and its ilk). It relies only on 
addition and logical choices, with 
very little number crunching. 

10 DIM NS(8192) 
20 N$="0":N$(8192) ="0":N$(2,8192)=N$ 
30 FOR I=1 TO 8192:IF NS(,I)="1” 


40 PRIME=I+I+1:CNT=CNT+1:K=I 

50 K=K+PRIME:IF K<8193 THEN 
NS(K,K)="1";GOTO 50 

60 NEXT I 

70 PRINT CNT: REM BETTER PRINT 
1899 


An aside: If you have seen the 
BYTE original and are puzzled by 
my changes, be aware of three 
things: (1) I had to use a string be- 
cause there is not enough room for 
an array of 8192 elements. (2) The 





Bill Wilkinson 


math was modified very slightly to 
accommodate the fact that string in- 
dices start at one, instead of zero. (3) 
Multiple statements per line simplify 
the original somewhat. 

Anyway, why is Atari BASIC 
so slow (317 seconds versus, for 
example, the IBM PC at 194 sec- 
onds)? Primarily for three reasons. 
First, note all the numbers in this 
listing, which must be treated as 
integers. Line numbers and indices 
are always kept and calculated as 
floating-point numbers, but all 
must be converted to integers 
before being used. (You simply 
can’t GOTO line 137.38, can you?) 
And, sigh, the routine in the Atari 
Operating System ROMs which 
converts numbers to integers is in- 
credibly slow (in fact, it is the only 
floating-point routine we modified 
when we produced BASIC A+ and 
BASIC XL). 

Second, Atari BASIC performs 
FOR-NEXT loops by remembering 
the line number of the FOR state- 
ment. Then, when NEXT is encoun- 
tered, BASIC must search for the 
FOR line, just as if a GOTO had 
been used. (Other BASICs remem- 
ber the actual memory address of 
the FOR statement. Faster, but less 
flexible. Atari BASIC allows you to 
STOP in the middle of a loop, 
change the program, and continue, 
something no other home computer 
BASIC allows. (This—among many 
other things—is in direct opposition 
to Consumer Reports’ claim that Atari 
BASIC is hard for beginners.) 

Third, if you type in and use 
this listing as shown, you are pay- 
ing almost a 50 percent penalty in 
speed, thanks to Atari’s screen 
DMA and Vertical Blank Interrupts 











taking up a significant portion of 
the processing time. The simple ad- 
dition of the following two lines 
will improve the time for this little 
test to 211 seconds: 

5 POKE 54286,0 : POKE 54272,0 

65 POKE 54286,64 

All of a sudden, Atari BASIC 
isn’t even near the bottom of the 
list. And, yet, there is more we can 
do to improve the machine's per- 
formance. As many have suggest- 
ed, you can install the Newell 
Fastchip, a replacement for the 
floating-point routines built into 
your computer (available from 
many dealers, produced by Newell 
Industries of Plano, Texas). 

Or you can change to another 
BASIC. Obviously, there is Atari’s 
Microsoft BASIC. It produces results 
very close to those of Applesoft; but 
it, too, can be improved by turning 
off screen DMA, etc. And there is 
OSS’s own BASIC XL. Using a com- 
bination of clever programming and 
a Fastchip, the BASIC XL program 
below will count up all those prime 
numbers in 58.5 seconds, about 
three times as fast as Microsoft 
BASIC on an IBM PC can do it. 
‘Nuff said. (Except a P.S.: The Set 3 
in line 10 requests zero-time FOR 
loops, something not available in 
many BASICs, which alone ac- 
counts for about 20 seconds worth 
of improvement.) 

10 FAST: POKE 54286,0: POKE 54272,0: 
SET 3,1: DIM N$(8192): N=ADR(N$) 

30 FOR I=0 to 8191 

50 IF NOT PEEK(N+1) THEN PRIME= 
I+I+3: CNT=CNT+1: FOR K=I+ 
PRIME TO 8191 STEP PRIME: POKE 
N-+K,1: NEXT K 

60 NEXT I 

70 POKE 54286,64:POKE 559,34: PRINT 
CNT 
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Measures Of Accuracy 

The Ah] benchmark is listed below. 

It purports to measure both accura- 

cy and number-crunching ability. It 

does neither very well. Still, we 

have to ask why Atari BASIC is 

near dead last in its rankings, re- 

quiring 6 minutes and 45 seconds to 

complete the test. 

10 FOR N=1 TO 100: A=N 

20 FOR I=1 TO 10: A=SQR(A): 
R=R+RND(0): NEXT I 

30 FOR I=1 TO 10: A=A’2: 
R=R+RND(0):NEXT I 

40 S=S+A: NEXT N 

50 PRINT “ACCURACY ="; ABS(1010- 
S/5), "RANDOM="; ABS(1000-R) 

The culprit here (in terms of 
time-wasting) is line 30, with its 
A=A‘’2, Atari BASIC, in common 
with most small computer BASICs, 
calculates powers according to a 
formula: 
xy = exp (y * log(x) ) 
where log() is the natural logarithm 
function and exp() is the exponent- 
of-e function. 

If you don’t understand that, 
don’t worry about it. The point is 
that the calculation of such a simple 
thing as a number to the second 
power involves the calculation of a 
logarithm and an exponentiation. 
And why is that so bad? Simply 
because the floating-point routines 
in the Atari OS ROMs are too slow. 
Again, the solution is to install the 
Newell Fastchip and/or turn off 
DMA and VBI (as outlined above). 

I am indebted to Clyde Spen- 
cer, one of the founders of the Bay 
Area Atari Users Group (one of the 
oldest), for supplying me with a 
most surprising figure. Spencer re- 
ports that, using the Fastchip and 
with DMA turned off, he obtained a 
timing of 1 minute 38 seconds, a 
very respectable (albeit not record- 
shattering) performance. | still 
wouldn’t use my Atari for advanced 
scientific applications, but it is more 
than adequate for most purposes. 

There is a problem with the 
“accuracy” figures in this test, how- 
ever. First, because Ahl’s accuracy 
number is the result of 1000 simple 
sums, it is clearly possible that a 
particular machine may exhibit 
wildly variant results for various 
numbers and still show a good fig- 
ure in his test. (To illustrate, assume 
that the SQR() function randomly 
tosses in an error of plus or minus 











one. If it tossed in an equal number 
of errors, they would balance to 
zero. Yet choosing to make the loop 
just one unit shorter [FOR N=1 TO 
999] might give a completely differ- 
ent result. To be fair, this is a very 
unlikely result with modern math 
algorithms; but, still, one never 
knows.) A minor change to his pro- 
gram would improve the testing 
qualities considerably: 


40S =S + ABS(A-N):NEXTN 


Do you see the difference? This 
method produces the sum of the 
errors, and doesn’t fall prey to off- 
setting errors, 


The Random Number Trap 
There is no hope for the accuracy of 
this random number tester, though. 
I will quote Clyde Spencer on this 
matter: “If the numbers are truly 
random and not normally distribut- 
ed, any difference between 0 and 
1000 is possible. All you can say is 
that you would have a high proba- 
bility of . . . being near zero for a 
perfect random number generator.”’ 
The benchmark test falls into the 
infamous BASIC repeating-ran- 
dom-sequence trap. 

In most BASICs, when you 
command a program to run, the 
pseudorandom generator is always 
reseeded with the same number. So 
each and every time you will get 
the same results, with Ahl’s test. 
And, depending on what seed is 
chosen, you may get truly phenom- 
enal results (because you happened 
to hit a hot spot in the generator’s 
sequence). Now, though, try start- 
ing the generator off with a differ- 
ent (and randomly chosen) seed 
each time. What happens? The 
test's randomness figure wanders 
all over the place. 

Once again, to quote Spencer, 
‘,.. in eight tests I obtained num- 
bers ranging from 1.6 to 24.2, with 
the mean being 7.02....” 

Finally, I would like to point 
out that Ahl’s test penalizes small 
machine BASIC interpreters in yet 
another way: When you have 32K 
bytes to spend on a BASIC, one 
thing you do is insure that numbers 
to a power are performed by 
successive multiplications, if possi- 
ble. Thus Cromemco 32K Struc- 
tured BASIC (for example) 
performs A*2 with just one multi- 
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ply. In other words, it converts A°2 
to A*A. If you manually substitute 
that same form in Ahl’s program, 
the times for almost all of the small- 
er and less expensive machines will 
improve dramatically. (Surprising- 
ly, though, the accuracy figures 
may not change. After all, the origi- 
nal version may have had offsetting 
errors.) Of course, if you need to 
use noninteger powers in your pro- 
grams, this comment doesn’t apply, 
and the benchmark’s results are a 
bit more meaningful for you. 

Well, what does all this long- 
winded discussion boil down to? 
Two simple points: (1) Always pre- 
sume that a benchmark program is 
worth slightly less than the paper it 
is printed on. (2) If you want to do 
number crunching on your Atari 
computer (against my best advice), 
go out and buy the Newell Fast- 
chip. (And it won't hurt to try some 
other languages.) 
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